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ABSTRACT 

CP/M-86 is a single user microcomputer operating system 
developed by Digital Research. This thesis provides a 
multi-user “protected #CP/M-86 based disk sharing 
environment consisting of four Intel iSBC 86/12A single 
board computers, a MBB-&8@ bubddle memory, and the REMEX Data 
warehouse 332283 memory storage unit. The REMEX houses a 14 
ince Wincnester hard disx and two flexible floppy disk 
drives providing in excess of 23 megabytes of data storage 
capecity. The major objective in the design of this system 
was to create a table-driven CP/M-c6 Basic Input/Output 
System that could be quickly and easily reconfigured to 
adapt to any new hardware configuration. Once the system 
was operational, the REMZX hard dis« could then serve as a 
“signal processor emulation for the AEGIS system. 3y 
making direct calls to the appropriate read/write routines, 
stored radar data could be retrieved from the hard disx 


for use Dy the other system processes. 
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I. INTRODUCTION 

A. BACKGROUND 

One of the most popular operating systems available for 
microcomputers today is the family of Digital Research’s 
CP/M operating systems. They are single user systems which 
@en of configured to interface with nearly any e2xistine 
piece On hardware simply oy redesigning tre Basic 
Input/Output System (BIOS) module of CP/M. Since CP/M is a 
Single user system, protection from other users is not 
mormally an issue of concern with this operating system. 

MP/M, also marketed dy Digital Research, is a multi-user 
Operating system which SupportS Muitiprogramming on 4 
Mprocessor. It is basically an exvanded versicn of CP/M. 
Pomever, MP/M provides virtually no protectior for user 
files and very little protection for memory in the event 
that another user’s process crashes. Furthermore, when more 
than one user is operating under MP/M, system response time 


is noticeably increased. 


Eee PURPOSE 

This thesis presents an implementation of CP/M-&S6 which 
will permit multiple users, each with nis own 
microcomputer, to access the same peripheral devices in a 


Manner similar to that of the MP/M operating system, but 
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with incr@ased user protection. The peripherals used in 
this implementation are a 52K common memory board, a MBB-&@ 
magnetic bubble memory configured as a floppy disk drive, 
and a Remex Data Warehouse memory storage unit consisting 
of a Winchester hard disk and two flexible floppy disk 
drives. ita addition, computer performance is not 
compromised since e#ach user has a dedicated INTEL &6/12A 
foe On which to operate. 

The standard version of CP/M-86 requires that only the 
BIOS be aitered to add additional hardware, a oeLe Toss 15 
an excellent method to interface hardware with CP/M, it 
requires that the BIOS be rewritten every time tne hardware 
configuration is changed. This process can vecome time 
consuming and is definitely prone to errors, thus 
discouraging frequent system reconfiguration. Therefore, in 
mee cesign of this system, a major goal was to develop a 
BIOS which could easily be modified if it was necessary to 
convert from one Sardware configuration to another. 

This thesis was based on work accomplished in two 
previous theses. Michael Candeélor’s thesis entitled 
“Alteration of the CP/M Operating System fRef. 1] 
ifitially modified CP/M-G6 to interface with the Intel i201 
ame i292 Fioppy Disk Controllers. Michael dicklin and 
Jeffery Neufeld, in their thesis Adaptation of the Magnetic 
Bubble Memory ina Standard Microcomputer Environment , 


[Ref. 2] interfaced tne MBB-8Z Budbbdl-Board and the i232 


eZ 








feorppy Disk Controller with the Ce/M-86 Operating System. 
Although Hicklin and Neufeld claimed that their BIOS was 
table-driven, it was Nicx Hammond who really daemeninted that 
the BIOS functions could be truly table-driven [Ref. 3). 
This thesis builds on the ideas contained in each of tnese 
previous works and expands upon them to create a more 
practical and versatile operating system which provides 
increased protection of the user’s address space and riles.. 

Once the system was operational, the REMEX hard ecisk 
could then de used to emulate the ‘sienal processor 
functions of the AEGIS system. Digect cells ican be made to 
the appropriate read/write driver routines to retrieve 
stored radar data from the hard disk for use by the other 
emilated processes in tne system. 

This thesis has been-organized into four major sections. 
Maes tirst section @@als with an overview of CP/M-EG and the 
necessary steps required to create 2a new CP/M-86 system. It 
oeero, oceScribes)6 how the BIOS interfaces with the other 
modules of CP/M-86 and the peripheral devices. Pieludedein 
Meee section is a description of how the BIOS can De 
reconfigured into a table-driven operating system wnich will 
permit easy alterations to the 3105S if the hardware 
configuration should be modified. 

Tree second section describes the hardware configuration 
Meriized in this thesis. The memory organization of the 


MBB-8@ Bubbl-Roard is discussed and the design decisions 





that were made to Make the bubble memory compatible with 
the CP/M operating sytem are treated in some detail. The 
basic functions of the REMEX Data Warehouse are also 
described, as well as, the command packet structure and 
erecution. 

The third section is concerned with the development of a 
CP/M-86 operating system which will permit four single board 
computers to operate simultaneously while sharine the same 
peripherals. In this design, it is necessary to provide 
protection to common memory during read and write operations 
and to insure that each user’s files are write orotected 
with respect to all other uses. 

The final section describes the tests that were 
conducted to evaluate system performance. Puede tongue 
feasibility of using the REMEX hard disk to emulate the 
"sienal processor. of the AFGIS system was exodlored. 
Measurements were made using direct calls to low-levei read 
routines to determine the optimum skew Pactor nor 
consecutive sector access operations. ALSO, some 
recommendations were made for future projects involving tne 
REMEX Data Warehouse and the Multi-user CP/M-&6 operating 


system. 
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A. THE CP/M OPERATING SYSTEM 

CP/M-86 is an operating system developed for use on a 
Single INTEL Corporation &6/12A microcomputer. Gor Par ais 
Supplied with a number of built-in utility commands as well 
aS transient utilities such as the assembler (ASMEG.CMD) and 
the Dynamic Machine Language Program Debugger (DDTSE.CMD). 
These are g@seri ged. inoedetail in Digital research 
Malications. (Refs. 4 - 6] 

The CP/M operating system itself is modularized to 
permit easy adaption of C?/M to any hardware configuration. 
The three modules are the Console Conmand Processor iCCP), 
the Basic Disk Operatinze System (B585DOS) and the user 
configurable Basic Input/Output System (BIOS). Tae fist 
two modules are supplied by Digital Research as a single her 
meee entitied CPM.Hé6. Phsmitle conmteinaseali “tne code 
necessary ing processing commands entered at the 
console and for handling all logical file and disk 
Management functions. Pieesounhce COage {fOr a SE®leton «F105 
is also provided which the user can alter to suit ais 
individual hardware requirements. Once the BICS has deen 
modified, it is assembled and then concatenated with 
Oem .Heo. THeer esi tine nex file, GCPMSIS.HE6, is converted 


to an executable Pile by the use of the CP/M utility program 


ale 





Le USER BIOS.A86 ==> ASM&86.CMD ==> USER BIOS .286 
E~ « orTm.neo + USER B1OS .HEG ==> PIP.CMD ==> CPMSYS.HES6 


3. CPMSYS.H&6 ==> GENCMD.CMD ==> CPMSYS.CMD 
(EGBE CODE (A4Q] ) 


4. CPMSYS.CMD ==> PIP.CMD == CPM .S25 
(rename on new disk) 


Figure 2.1 
Svepe tor Creating CPM.STS 
GENCMD.CMD. Finally, this file is renamed CPM.SYS and placed 
on a diskette for use. This process iS shown in Figure 2.1. 
Details concerning the operation of GENCMD.CMD, LDCOPY.CMD 
and PIP.CMD can be found in the CP/M-86 Operating System 
Guide . [Ref. 6] 

GP/M—-66 supports programs written in three memory 
models: the 88822 Model, the Small Model, and the Compact 
Model. All three memory models are described in detail in 
memwerence 95. the med@ivused in this thesis 15 the E250 
Model because it Supports programs which have code and data 
areas intermixed and which normally have single segments of 


64K bytes or less. 


B. LOADING CP/M~-86 

moe Tile CPM.SYS 15 too lerge to fit onto the first two 
tracks of a normally-formatted diskette. Thus, a boot 
loader must be placed on these tracks and loaded into memory 


by the cold start loader. This boot loader program will 
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then bring the main CP/M operating system into memory and 
mass Control to it. 

The loader program is distributed by Digital Research 
in three separate modules and is basically a subset of the 
entire CP/M system. The modules are the Loader Console 
Command Processor (LDCCP.H&6), the Loader Disk Operating 
System (LDBDOS.H86), and a user configurable Loader Basic 
Input/Output System (LDBIOS.A&S6' which is almost identical 
to the system BIOS. Toe primary differences deal with the 
physical memory location of the loader, the interrupt 
Structure and the BIOS offset address within the CP/M 
system. Assembly of the loader BIOS is controlled dy a 
@emaqitional assembly switch provided in th@® skeleton BIOS, 
Which is listed in Appendix E of Reference 6. The steps 
needed to obtain a loader BIOS are essentially the same as’ 
more creating tome CPM.SYS. The exract steps are shown in 


Meure 2.2. 


1. USER LDBIOS.A86 ==> ASM86E.CMD ==> USER LDBIOS .REG 


eeeuLCCP.c66 + LDBDOS .H&6 + JSER LDBIOS .¥86 == Pir .oue 
== LOADER .Ho6 


Oo. LOADER.H86 ==> GENCMD .CMD 


==> LOADER.CMD 
(8989 CODE [A499] ) 


4. LOADFER.CMD == LDCOPY .CMD == LOADER .CMD 
(load on tracks @ and 1) 


POeuUre se. 6 
Steps For Creating Boot LOADER.CMD 
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Ce DOOTSTHAPPENG THE ISSCC 86 /12A 

Brom the monitor of the iSBC S6/12A, thewmCcP/M system 
loader program located on tracks @ and i of the disk, can 
be accessed via the bootstrap or cold start loader program. 
This program is located in ROM or EPROM on the {SBC &6/12A 
board itself. Thus, for each separate device from which the 
system is to be booted, a new cold start loader program must 
be written and thén burned into ROM. Finally, this ROM must 
be mounted on the iSBC &6/12A board where it can be accessed 
oy the monitor program. 

Currently, two cold start loader programs ae available 
mor the iSBC 86/12A. One allows the system to be booted 
from either the single or double density Intel MDS floppy 
disk drive system by executing the command GYFD4:@ from the 
iS8C 86/12A 957 monitor program. When this command is 
executed, the program in tne OM will go out to tracks @ and 
1 of the floppy diskette and attempt to bring into memory 
the CP/M system loader program. Once loaded into memory, 
meee cold start loader will then transfer control to the 
loader which in turn will locate the CP/M system ({(CPM.SYS; 
On the disk and load it into memory. Finally, the system 
loader will relinquish control to the CP/M operating system. 
The source code for this bootstrap program is listed in 
Appendix C of Reference 1. 

The second program allows bootloading from tne MB3B-8¢ 


bubble memory device dy issuing the command GFFD4:4. 





Currently this last command can only be used when operating 
on the iSBC 86/12A which is labeled #41, as it is the only 
computer .with an EPROM that contains the cold start loader 
for the bubble memory. The source code for this program, 
which was developed by Hicklin and Neufeld, can be found in 
Appendix D of Reference ec. 

This thesis uses the dubble memory to initially boot 
the system. Therefore, a new cold start loader program or 
CP/M system loader program did not have to de deveslored. 
All that is required to change the operating syster tnat 
will be loaded is to place a new CP/M system (COM.SYS) on 
the bubble memory storage device. 

The loader program placed on tracks @ and 1 of the 
bubble memory used for loading the CP/M operating system is 
entitled MBS@ZLDR.CMD. This file is created by following tae 
Steps indicated in Figure 2.2 utilizing MEG@BICS .Ac6 as the 
source file with the loader conditional assemodly switch sez 


mor true. 


D. DISK PARAMSTER TABLE 

The CP/M-86 operating system as marketed ody Digital 
Research is considered a table driven system since all 
characteristics for each I/O device is placed in a tabdle 
called the Disk Parameter Tadle which can handle up to 
sixteen separate devices. This table defines the logical 


organization of the physical storage media for the 38DOS file 


( 


Management functions and must de included in every IO 


i 





A disk defimition statement is required for each 
physical device and consists of a sequence of words which 
define the characteristics of a device. Figure 2.5 shows 
the format of a disk definition statement. These statements 
are then used to generate the Disk Parameter Table by 
executing the utility program entitled GENDEF.CMD [Ref 6, 


p.72]. The file created by this program must be included in 


ioe DEF: dn, fsc, lsc, [skf], bls, dir, cks, ofs, [@] 


where 

dn is the logical disk number (90 to 15) 

fsc is the first physical sector number (2 or 1) 

lsc is the last logical 128 oyte Sector number 

Sk? is the optional skew factor 

bls is the data allocation block size 

dsk is the disk size in bls units 

dir is themgumber of directory entries 

cks is the number of checked directory eatries 

ofs is the track offset to logical track 2 
(normally 2 as track @ and 1 contain the loader) 

[J] is the optional 1.4 version compatibility flag 


Figure 2.3 
Format of Disk Definition statement 

the BiOS using an include” statement. The file which 
contains the disk definition statements for this thesis is 
labeled CPMMAST.DEF and used to generate a Disk Parameter 
meelies which is located in the file called CPMMAST.LI3. 
These two files can be found in Appendices G and 4. 

Do credtie.a disk definition Statement for the table, the 
Gaamacteristics for the device must be xnown. This 


information is uSually located in the technical manuals for 
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the given device. For example, the disk definition 


statement used for the REMEX Winchester hard disk was: 


DISRDEF 3,1,196,0,16384,255,128,0,1. 


The first ‘3 indicates that the hard disk is CP/M’s 
logical drive number "3° and can be accessed via the "D:° 
command from within CP/M. 

The next two numbers corresvond to the first and last 
logical sector numbers for the Winchester nard disk as seen 
by CP/M. The actual physical sectors for the nard disk are 
numbered from 1 to 39, each containing 512 bytes. Sane e 
CP/M requires the number of logical 12E byte sectors, 3839 15 
maitiplied by 4 to produce 156 logical sectors of 128 bytes. 
The actual mapping from the logical to the physical sectors 
is accomplished in the blocking and deblocking subroutines 
located in the code for the AEMEX hard disk (RXHARD.AcE) and 
is described in more detail in the Chapter IV. 

The REMEX technical manual does not indicate wnat the 
most effective skew factor is, thus zero was chosen obdecause 
it was required by the dlocking and deblocking routines. 
However, an optimal skew factor may de determined 
experimentally when the REMEX hard disk is used to emulate 
the ‘signal processor of the AEGIS system. If so, the 
blocking/deblocking routine will have to be modified at that 


time. 
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ee 


The "bls parameter specifies the number of bdytes 
allocated to each data block. This number can de 1924, 
2648, 4896, 8192, or 16,384. When larger block sizes are 
used, each directory entry can address more data. This 
reduces the amount of work that the BIOS must do, resulting 
in reduced system response time. Therefore, a block size of 
16,384 was chosen. 

The “dsk specifies the total disk size in terms of data 
bl6cKs. It is derived by cividing the total byte capacity 
of the disk by the data block size. In this implementation, 
the Winchester disk contains approximately 20 megabytes of 
data storage which is subdivided between four separate 
neads. Thus 4,193,289 bytes are allocated to the “D: drive 
mee this figure is dividéd by 16,3&4 to produce 255 data 
blocks. 

The next figure, i12&, indicates the number of directory 
@ntries that are permitted on this drive. 

The ‘cks term determines the number of directory items 
to be checked on e€acn directory scan and is primarily used 
for detecting changed disks during system operations. As 
the Winchester disk is permanently mounted, a value of zero 
was chosen for this parameter. 

ine ‘ofs value determines the number of tracks to be 
Skipped when accessing the disk. In essence, it reserves 
tracks for permanent storage. Trace 2 is reserved since the 


Remex requires it for internal system use and errors wiil 


ee, 





@ecur if an attempt is Made to access it. Qn a floppy disk, 
this value is usually two as tracks @ and 1 are normally 


reserved for the loader program. 


fee SOE STANDARD BIOS 

The BIOS for CP/M-86 always begins at an offset of 2599 
hex from the beginning of the CP/M-86 operating system. At 
this location are twenty-one entry points used dy the CCP 
and the BDOS to gain access to the 3810S functions. These 
entry points form a jump vector to otnrer Subroutizes in tne 
BIOS which contain the necessary code to interface with each 
hardware device. 

There are three types of functions in the 3I0S: system 
Mertialization/reinitalization, simple character I/C and 
Gece 1/0. Several of tnese functions are normally not 
implemented in most microcomputer systems, while otners 
require extensive and quite different code implementations 
for e@ach separate device. HneeS105 “a4l50 Contains the Dis« 
Parameter Tables wnich represent the pnysical description of 
the disk drives. Finally, located at the end of the 3105, 
there is a scratchpad area for certain BDOS operations. 
Figure 2.4 snows the memory map of tne #FIOS. 

moe | order to simply access a diskette, several furctions 
locatec within the BICS may have to be performed. Lor 
example, to access the directory of a diskette, the %35D0S 
will require tne following functions to be performed by the 


BOs : SELDUSK, HOME, SETTRK, SETSEC, SETDMA, SaTDOMAB and 
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CS DS, ES, Ss: 
CONSOLE COMMAND 
PROCESSOR 


& 
BASIC DISK OPERATING 
SYSTEM 


—_ ew o8 ow ee fe a= Ow ©! ow 2 ee oe | ce oe = ow 


CS + 25008: 


Us) + 250r8 : 


DISK PARAMETER 
TABLES 


UNINITIALIZED 
SCRATCE xAM 


= 82 oe cece 2 oo ow SS ow FO] CF OW ee 6 aw es 8S 8] © oe oF Se oe 8! FE 2! oe ow! FE 2 68 22 28 6 ow oe SF SP gs oe 7 


=—— ow SB ee 8] 8] cwewe Fe 22 ow FS op = 22] ow wwe of ow OS == ew 


Figure 2.4 
Memory Map of the Standard BIOS 


moe. (Ref. 6: p.62] For each function executed, the BICS 
will have to determine which physical device is being 
accessed and then jump to or call the subroutine which 
contains the code for that specific device. For example, 
Suppose a simple READ function is required by the BLrOS. ee 
Weel initiate a call to the BIOS READ entry point weicn in 
mien Will vector the call to the READ Subroutine. kere the 
BIOS will determine which physical device corresponds to tae 
CP/M’s logical drive and then jump to tne appropriate code 
to read data from that sp@€cific device. (See Figure 2.5) 
This procedure is very logical and makes it easy for a 


user to implement his specific device dependent 


24 





CCP --- 
'—----> call to BIOS to Read Device #2 -->--- 


l 
| 
| 
| 
| 
1 
| 
™ 
1 
{ 
1 
| 
' 
1 
| 
| 
| 
; 
{ 
1 
~\ 
! 
| 
| 
1 
| 
i 
| 
| 
f 


init: 
code for initializing all devices 
ret 


write: 
code for writing to all devices 
ret 


mmem wes wie OS® on ow OS awe ap = ow oD 


mmr —>———-READ: 
determine device 
jmp read _daevice #1 
JMP READ DEVICE #2 -—-->----- 
jmp read_device #3 ; 


becca woevilces L: 
code for reading device #1 


ee oe ee ee ee ED oe 


ret 
—— SS —— HD Device ve: 
CODE FOR READING DEVICE #2 
RET 


read_device #3 
code for reading device #3 
rey 
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Path of CCP or BDOS Function 
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code. However, problems arise if tne hardware conriguration 
must be altered. fverytime the configuration changes, the 
code for each function in the BIOS must be rewritten. sip ole 
can be a time consuming task. In addition, asSumptions made 
concerning the implementation of one configuration may lead 
to errors in another configuration should those assumptions 
Mor Logger be valid. These @rrors may also be extremely 
difficult to locate and correct since all code is usually 
intermixed and the exact order that the CCP and BDOS call 


various functions in the BIOS is not Known to the user. 


F. BIOS ALTERATION 

Hicklin and Neufeld attempted to develop a table driven 
BIOS. ta a manner of speaxing they succeeded. However, the 
only devices that are permitted in their device tabie are 
additional Intel MDS double density disk drive systems and 
MBB-80 bubble memory storage devices. Attempting LO 
integrate another device such as the REMEX Data Warehouse, 
leads to the same probdlems which were mentioned earlier. 

To alleviate these problems, a completely table-driven 
BIOS was developed in which only minor and straight-forward 
Changes would have to be made in order to change hardware 
configurations. This was accomplished by extracting out all 
the device-dependent functions of the 3210S into separate 
files for each unique device. Specifically, these functions 
were INIT, SELDSE, HOME, SELTRE, SELSEC, READ, and #wRITE. 


Functions such as WROOT are not dependent upon a particular 
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device and do not have to.dve extracted, while functions such 
as PUNCH and READER are not implemented. 

In the hardware configuratiozr for this thesis, toree 
separate files were required. These were MBS@QDSK.AEE, 
RXFLOP .AG&6E, RXHARD.AS&6. These files each cortain the 
necessary code to execute the seven device-svecific 


functions for the MBB-89 bubble storage device, the Remex 


CONSOLE COMMAND 
PROCESSOR 
& 
BASIC DISK OPERATING 
SYSTEM 


a EE &- Cb Gb ou => ae E> am an Pam a= awe GDP ap co GS GD = aw = ana 


BIOS JUMP VECTOR 


Cou tecoies. 


CS eteZ2eorbi 
BIOS SUBROUTINES 


INCLUDE LABEL TABLES 
INCLUDE DEVICE #1 
INCLUDE DEVICE #2 
INCLUDE DEVICE #2 


INCLUDE DEVICE #16 


DISK PARAMETER 
TABLES 
UNINITIALIZ 2D 
SCRATCH RAM 


ela ee ete ee | Oe ee ee ee ee, el ee lL 


ae eet eee ee eee ee ge es ee ee ee ee ee ee ee ee ee ee ee ee es ete Se ee ee ce ee ee es ee ee ee ee ee ee ee 


Peers 2 6 
Memory Map of the Tabdle-Driven 8105S 
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floppy disk drives, and the Remex hard disk, respectively. 
An additional file, CPMMAST.CFG, is also now required. It 
contains tables of labels waich correspond to the physical 
memory location of the seven functions for each device used 
in a given hardware configuration. The label tables used in 
this thesis can be found in Appendix C. Figure 2.6 shows 
the memory Map of the table driven BIOS. In the BIOS, the 
assembly language instruction ‘include is used to 
incorporate the label tables and device-specific code for 
the seven functions into the system. 

For example, when acall is made to read Device #2 from 
the CCP or the BDOS, the call is vectored as was done before 
through the jump vector to the READ Subroutine of the 3108S. 
Sowever, after determining the physical device to be 
@ecessed, insteed of jumping directly to the desired code, a 
call is now mad@2 to the device specific code located in the 
included device’s AG6 file via the Read Table which is 
located in the file CPMMAST.CFG. The final address of the 
call is determined by the offset of device number into the 
Read-Table, which provides the label or 16-bit address of 
the actual code needed for reading Device #2. (See Figure 
eet } 

To alter the hardware configuration, only one line ina 
the BIOS must now be changed for each device, that being the 
corresponding “include statement. The otner changes which 


are required, are located in the label tables and the Dis«x 
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CCP & BDOS ---> call to BIOS to Read Device #2 -->--- 


a (eee ee nn - - - - - - ¢ —— oo a 
| 
l 
ieeeoS: jmp init 
jmp write 
——--- > JMP READ ---->------ 
] 
| 
jmp wbdoot 
} 
| 
Se an oe oo oe {err eee-- -——<— SS 
ienet 
call to init label table 
ret 
write: 
Cail to write laoel table 
ret 
——————— >—---R EAD 
determine device 
CALL READ TABLE [offset device #2] --->---- 
ret 
} 
| 
eS See ee = 


INCLULE LAbah. TABLES 
imdeteltia DLE 

labels 

: write table: 
labels 

READ TABLE: 

read device #1 


include device 41 
code for seven device specific functions 


INCLUDE DEVICE #2 
init_device #2 
code Wor initializing Device #2 
wri te device #2 
code for writing to Device #2 
—o P———--—— hee) DEVICE #2 
CODE FOR READING DEVICE #2 


ome ae nee ee ee ee ee oe ce OO 8 
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Call in Table-Driven BICS 
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Parameter Tables. For each device included in the BIOS, 
there must be a corresponding label for an abstracted 
munction. These labels must be correctly ordered and 
properly identified. Naturally, when hardware is 
implemented into the system for the first time, the initial 
code for performing the seven device-specific functions must 
meewritten. But once written, the new device can be added 
or deleted from the operating system with very little 
effort. The fact that all code for each device is completely 
independent of other devices, aids in detecting, locating 
gea correcting errors. Actual experience has shown that 
once the code for a device has been written, going from one 
hardware configuration to another can be accomplished in 


under twenty minutes. 
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IIT. HARDWARE 

A. GENERAL HARDWARE CONFIGURATION 

1pe Hardware configuration utilized in this thesis 
eomsists of four iSBC 86/12A Single Board Computers, a MBBE- 
&Q@ Rubbl-Board, a 32K byte common memory dDoard, and the 
REMeX Data Warehouse memory storage device witn Multibus 
Interface Card Assembly. The components are all Multibus 
compatible and were placed in an iCS-8@ Industrial Chassis 
more system oOpe@ration. Fleure 3.1 depicts the physical 
hardware configuration. Tabdle 3.1 describes the logical-to- 
physical mapping »detween tne CP/M representation of the 


system and the actual physical hardware. 


a —|— Pan EP am a EE GE SS = =p emcee GHP ee GP eee 6 a= aap oe GP ow oe SP eee SS ae Oe ss ae SE a 
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Physical Eardware Configuration 
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Ta DiljOe oo. 
Logical Eardware Configuration 


mor/™ S$ bogical | Actual | Actual 
ee eee ee tn Ehysical Deve 
‘ g | A: | MBB-E€2@ Bubble Memory ! 
_—“. |B: | Remex Floppy Disk Drive | 
—_. . Se ear Bax tal | 
_— 5s. | Dr | Remex Hard Disk Head a | 
-_— 4” |g: | Remex Hard Disk dead 1 | 
~~ ieee Ge | oF: | Remex dard Disk Head 2 | 
Oe 6 | og: =| «Remex Hard Disk Head 3 | 


B. INTEL 86/12A SINGLE BOARD COMPUTER 

The Int2l iSRC 86/12A Single Board Computer is a complete 
computer system constructed entirely on a single Multibdus- 
compatible circuit board. It is designed to operate as a 
Standalone system, 4 bus master in a single bus master 
System, or a vbus master ina multiple bus Master system. 
The board itseif contains an Intel E GEE Pes ect 
microprocessor, E64K bytes of dynamic RAM memory, 16K bytes 
of EPROM memory, both serial and parallel I/0 ports, a 
programmable timer and interrupt controller, anda Multidus 
eoeerface controler. 

Onboard RAM memory is located between @ and ¢ffffh and 
the "PROM bdetween FFCOCh and FFFFFh within the 1-Megabyte 


2ddress space available to the Intel &€&6 microprocessor. 
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If the local processor attempts to address memory outside of 
these ranges, a Multibus access will result. The onboard 
RAM is dual-ported, and therefore 1s accessible to the local 
Meeee@ssor Vid an internel bus, as w@ll as, to any external 
Multibus master via the Multibus. In this latter case, the 
onboard RAM is operating in the RAM-Slave mode. Any 
collisions tnat result when the RAM is Simultaneously 
accessed by tae local CPU and the Multibus are resolved by 
meameware in favor of the local CPU. 

While the location of RAM relative to the local 
processor is fixed between @ and FFFFh, 1t can be switcnh- 
and- jumper configured into any 12EK segment of the i1- 
Megabyte address space relative to the Multibdus. Se 
Beemmoo0n, none or ali of the onboard RAM, in segments of 
Meee May be reservéd strictly for local CPU use. Since the 
Major objective of tnis implementation was to produce a 
CP/M-based multicomputer system in which each computer 
operates totally independently of the others, each iSRBC 
86/12A was configured to make all of the onboard RAM 


inaccesible to the Multibus. 


C. MBB-82Z BUBBLE MEMORY STORAGE DEVICE 
tee Gereral Description 
The MBB-80 3ubd1-Board is a complete budble memory 
mooceace dévice designed to o® compatible with all 8- and 16- 


pat microcomputers that LEZ e Intel ’s Multibus 


architecture. Diemmeoodre Consists Of Client (8) TIB9295 
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bubble devices and the necessary control, buffering, and 
Multibus interface logic. The host CPU interfaces with the 
MBB-E® controller via memory-mapped I/0 utilizing any 
sixteen (16) consecutive user-defined addresses within the 
1-Megabyte System address space. These sixteen (16 ) 
addresses correspond to the sixteen (16) registers in the 
bubble memory controller that are utilized in support of the 


following controller primitive commancs: 


Pll Buriter Read Multiple Pages 
Empty Buffer Initialize 

Write Single Page Read Status 

Read Single Page Enable/Disable Interupts 
Write Multiple Pages Reset 


2. Read/Write Logic 

Read and write operations with the MBB-&d are 
accomplisned by specifying a particular bubble device number 
and page number (18 bytes) to read from or write to. The 
MBB-6@ controller provides the ability to read or write in 
either a single- or multiple-page mode by using a Dbyte-by- 
byte transfer into a FIFO buffer located on the MBB-8d board 
itself. The single-page mode can be implemented in a 
Straieght-foward Manner without the need for addtional 
Supporting nardware or software. However, the multiple-page 
mode requires that certain timing requirements must be 
adhered to by the host CPU when communicating with the MBB- 


&G controller. During adata transfer, the host must 
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respond to interrupts generated Dy the MBB-&@ every 162 
microseconds which signal the completed transfer of one byte 
of information in a multi-byte transfer. These interrupts 
can be generated on the Multibus and handled by the 
Programmable Interupt Controller (PIC), or the host CPU can 
poll the controller interrupt register (offset doOfh) to 
determine if an interrupt has occurred. The sinaie— and 
musti-page polled modes were implemented dy dicklin and 
Neufeld {Ref. 2]. The final version of their system 
weil i zed the multi-pege polled mode and tnois was 
supsequently employed in this implementation. 
3. CP/M-8E Compatibility 

In order to effect a data transfer, the MBB-8d 
controller must be given a device anc initial page number ta 
locate the position where the data will be read from or 
mee ven tO. On the other hand, C?P/M uses a track and sector 
number to access data during a disk access. Therefore, a 
Mapping must be made from the CP/M track and Sector number 
to MBB-88 device and page numbers if the C?/M operating 
System is going to be used to access data on the MBB-&8@ 
Bubbl-Board. Hicklin and Neufeld [Rer. 2] decided to use 
the bubble page number as the smallest addressable unit for 
each data transfer and the basis for the MEB-EC memory 
organization. Since each physical bubble page is eighteen 
(18) bytes long, a logical CP/M sector of 128 bytes consists 


of eight (8) bubble pages of which the last sixteen (15; 
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bytes on the last page are not used (i.e. wasted). 
Therefore, the 6428 bubble pages per device are eemed’ ane 
89 logical CP/M sectors per device. Futhermore, it was 
decided that each MBB-80 “track would consist of 26 sectors 
which corresponds to the number of sectors per track on 4a 
normally-formatted Single-density floppy disk. Another 
design decision was that all MBB-8@ trac«s would be 
conpletely contained on a single bubbie device. Since there 
are 26 CP/M sectors per track and &@ sectors per bubble 
device, this results in three (3) tracks per bubble device 
with two (2) sectors not used or wasted on Each device. 
Therefore, based on these design decisions, tae total 
peyeaic ity of the MBB-89 Bubbl-Board is 7&K bytes on 24 tracks 
(6 devices x 3 tracks per device) with a total of 14x bytes 
wasted. Hicklin and Neufeld’s final memory organization for 
the MBB-8g is shown in Figure 3.2. Dispite its 
bmpetficiency, this configuration was adopted for this 
implementation since the principal function of the dubddle 
memory is to provide a convenient method of booting CP/M-&86 
On our Master iSBC 86/12A. Hammond ([Ref. 3] has shown that 
there is amore efficient way to organize the MBB-@a@@ in his 
wOorx on utilizing the MB3-89 as a snared resource in a 
multi-microcomputer system. However, this would have 
necessitated the design and implementation of a new 


meeustrap loader program to be pleced in the iSBC §&6/1z2A 





BPROM and Was not judged to be of significant importance for 


this implementation. 
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D. REMEX DATA WAREHOUSE 
1. General Description 

The REMEX Data Warehouse is a mass storage memory 
unit containing a fixed Winchester disk drive, two (2) 
flexible diskette drives (single- or double-sided), and a 
meenoprocessor controller that s@rvices all drives. The 
memory capacity of the fixed disk is approximately 2¢ 
megabytes and the flexible diskettes can de formatted to 
contain up to two (2) Megabytes of storage. IEM standard FM 
encoding is used for the single density floppy diskette 
while MFM encoding is utilized for the double density 
diskette and the hard disk. 

The fixed disk’is a 14 inch enclosed disk utilizine 
Mone ster technology and is composed of two recording 
surfaces. Bach surface has two (2) recording heads which 
Meme €ach access a total of 213 tracks. Bach track can 
contain up to 24K bytes of information. However, only 219 
tracks can be referenced for normal read/write operations. 
muemmcard disk Sector size is switch-selectable to either 
128, 256, Sil2, or id24 dytes per sector. The total storage 
capacity for the various sector sizes is shown in Taole 
eee in addition, tne floppy diskette controllers are also 
Switch-selectable to handle either single or double density 


Semmes tes. it is extremely important that these switch 
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Teme: Ose 
REMEX Hard Disk Sector Selections 


resector Siec@! | Sectors/Track Capacity 
+ 428 «| 104 ~~ | 18.9M bytes | 
1 286 | 67  { 14.4M dytes | 
; sz ft | 39 «| -16.8M dytes | 
1 1924 —Ssi}stst=<«Sttss:s*«<Sti«i RAM tens 
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disk and diskette for the read/write operations to function 
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The REMEX Data Warehouse (RDW) is designed to 
transfer all data and command structures to and from the 
nost computer via direct memory access (DMA). To initiate a 
RDW operation, the host computer duilds a command packet 
Mmeeman its local memory. This pacxet cortains all the 
information necessary to effect an R2DW operation. The host 
then sends the address of the command packet to the HDW via 
an interface doard utilizing programmed I/0. When the RDW 
is ready to accept packets, it inputs the command packet via 
DMA, performs the required function, and transfers any data 
via DMA. When tke function is complete, the aDW indicates 
this by noting it in the command packet status word or ody 
generating an interrupt on tne Multibdus. Packets can be 
queued in the RDW up to a maximum of eight. 

some other important features of the HDW include: 


=—"Dynamic data bduffering (2Kex 16 bit buffer) 
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allows a continuous transfer under varying CPU 
Cone ts Ons. 

-- Dynamic buffer protects against data overrun and 
underrun preventing loss of data without host 
commurter im vervention. 

-~- Allows data transfers in large blocks of up to 
644 words with a single command. Heads are 
automaticaliy advanced as necessary. 

-- Automatically seeks to track(s) required in 
command packet. 

—~ Permits chaining packets together in 
noncontinuous memory. 

== ahd iviel ty to format entire disk with a single 
command. 

—~-Automatic verification and assignment of 


alternate tracxs to cover bad tracks. 


2. Command Packet Crganization 
The basic structure of the command packet is shown 
in Figure 5.5. Word @ is composed of a modifiers section, a 
Mmmmet1on code block , andaitlogical unit section. The 
Pie tion code dlock specifies which of the six (6) 
particular REMEX functions is to be performed. These 


functions are Read, Write, Write ID and Record, Copy, 


Format, and Maintenance. 
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Command Packet Description 


A program in the RDW interprets the function number 
and determines how many words are required for each specific 
command pacxet. The modifiers section contains information 
on packet chaining, program control interrupts, disabling of 
error routines and an “end marker which specifies a single 
Pacméet or the last packet ina packet string. The logical 
unit can be either 9, 1, or 2. A zero always corresponds to 
the hard disk. However, the floppy diskette drive can bde 
operator-configured to respond to either logical unit number 
amore 2. This is accomplished by the Device Logical Unit 
Switch located on the front panel of the RDW. 

The Status word is divided into tne Least 
Significant bits (3-7) and the most significant bits (8-15). 


mach of the least Significant bits, when set to (1), 
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Tare O.0 
REMEX Error Codes 
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' Bit No. | Description : 
+ @ {Normal Completion — | 
4. tC ASsignea ti (iti‘“‘~*S 
1 @ |  Gontroller Error | 
os the FS Drive Error (ati(‘sé‘és 
1 4a | GRO Error $} 
Ps i+  WM@gal packers 3 
a Bad Track During Format | 
™ 7 “(deo Nebasstened  #§«§ | 


represents a particular status which is indicated ina Table 
3 oad BAtCS Geuia Gepresent the hex code that corresponds to 
the error definitions given in Table 3-6 of Reference 7. 

Words 2 through N are function dependent and the 
number of words per command packet varies widely between RDW 
Operations. In tae version of CP/M developed in this thesis, 
only the Read/Write function are implemented and are used to 
@ecess and transfer data. However, addtional utility 
pooerams wer@ written which utilize the other functions to 
format the hard disk (RXFORMAT.CMD) and to execute the 
ouilt-in maintenance programs (RXMAINT.CMD) of the RDW. 

The format of the Read/Write packet is Shown in 
Pagure 3.4. The description of these two operations is 


Pomemitical except that ina read operation a one (ij is 
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Bit Number 


ibs me 4 3 0 

Word @ | | Modifiers =| ‘Function {| Unit. } 
eS Status Word ttsts—i~*S 

— Track Number sis: 
3} lead Number | Sector Number 

2 | Memory Address of Data (16-bit) =} 

5} «ss Bxt Memory Addr Bits 

6 | Transfer Word Count (# of 16-bit words) | 
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Figure 3.4 
REMEX Read/Write Packet 
Meesead in the function code block of packet word @ and for 
a write operation a two (2) is used. Both operations are 
permitted in blocks of up to 644 words. Any nead switching 
or eevancinge woich May be reqwmired is automatically 
performed by the RDW disk controller. 

Fie track Numbeérsmare assigned from 1 to <41@ for 
normal data transfer operations. Track 015 always reserved 
for a loader or system program and can not de addressed 
during a normal read or write operation without generating 
Soe error. Presently, the hard disk is formatted for 512 
oytes per sector which corresponds to $9 sectors per track. 
aeaa numbers for the four RDW heads run from J through 3. 
Data addresses are a 24-bit representation of the 28-bit 
address structure Supported by the iSBC 86/12A and Multibus 


~~ 


architecture. The transfer word count is the number of 15- 
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Meee Words that are’ to be transferred. For accessing the 
hard disk, a transfer word count of 1@€h was placed in the 
packet built by CP/M. This figure corresponds toa single 
sector (512 bytes) or 256 16-bit words on the hard disk, 
which is equivalent to the CP/M-86 Operating System view of 
512 8-bit words. 
5. Multibus Interface Card Assembly 

The command packets are sent to the Row via a 
Multibus Interface Card Assembly. Tne interface contains 
all “the necessary buffers, registers and control logic 
required for the transfer of data, status, addresses and 
commands between the REMBEX Data Warehouse and the i530 
86/12A Single Board Computer. Tne interface operates in both 
a programmed I[/0 mode and a DMA mode. All data, status, and 
commands are transferred by DMA, while packet addresses and 
the interface Command/Status information are transferred via 
programmed I/0. During these transfers, the eid ct? pis 
Interface acts as a bus master in the DMA mode and as a bus 
slave in the programmed I/O mode (Ref. @]. Registers are 
provided for data, packet address holding, and DMA 
addresses. A DMA address counter (28 sits) allows memory 
addressing of up to i-Megabyte. Control logic for DMA, bus 
pumone, interrupt control and device address selection is 
aiso provided. selection switches are available to alter 


tne interface base address, interrupt priority level, and the 





DMA throttle wnich governs how long the interface must wait 
vetween DMA transfers. 

In the programmed I/0 mode of operation, tne 
Multibus Inteface responds only to 1,0 port addresses. 
Switches, as mentioned above, are used to set the base 
interface port address. The standard addresses for the 
Command/Status Register are port address Q7YG (Least 
Seenificant byte) and port address @71 (most significant 
byte). The standard addresses for toe Packet/DMA Register 
are port addreses 972 and 973. A more thorough description 
of the contents of these registers is given in Table 3-2 of 
Reference 7. 

The DMA Throttle Select is used to select the number 
oF Multibus accesses that must de completed vetween 
consecutive DMA transfers by the Multibus Interface. A 
selectable range of 93-15 transfers is provided. The standard 
meer nost Multibdus cycle between interface DMA cycles. This 
memmmcontrary to the explanation given in Section 2.3.3 of 
Reference 7. In this section, the DMA throttle is presented 
in terms of number of processor cyles instead of Multibdus 
accesses. 

4. Commanc Pacxet Execution 

To execute an operation contained in a command 
packet, the host computer Must first test the Packet Address 
Ready Flag (port @70) which indicates whether the RDW is 


ready to accept and process command packets. be this elae 





is set (1), the host loads the extended address bits (bits 
17-22) of the command packet into the Command /Status 
Register (port 972). Then the least significant byte 
followed by the most significant byte of the i6-bit address 
of the command packet must be Loaded into tae Pacx«et/DMA 
Register (ports @72 and 873 respectively). This sequence 
must be followed exactly because once tne most significant 
ovyte is loaded into vort 373, the interface board signals 
toe RDW that the address 1s complete and ready to be 
meansierred. 

Upon receiving this signal, the RDW will read the 
eearess which was placed in the ports of the interface 
voard, fetch the command packet located at that address, and 
perform the operation specified in the function code blocs 
meee pacxet. When the operation is complete, an entry is 
made into the command packet status word (word @) indicating 


the success or failure of the operation. 


BE. ICS-&@ INDUSTRIAL CHASSIS 

[re icS-89 Industrial Chassis consists of four (4) four- 
Slot iSBC 604/614 Cardcages, four fans, a power supply, a 
control panel and a 19 RETMA (Radio-Electronics-Television 
Manufacturers Association) -compatible chassis. The control 
meme consists of an on/off/loc« key switch, interrupt and 
reset pushbuttons, and halt/pwr on/run LED’s. 

The development system was designed to support a modular 


microcomputer-based system. Any combination of plug-in 
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modules which are Multibdus-compatible may be installed 
including single board computers, memory expansion boards 
and peripheral interface boards. The iSBC 664 Cardcage can 
accomodate four (4) iSBC circuit boards and has an external 
plug which allows additional iSBC 614 Cardcages to be added 
to the chassis. The laboratory system used in Support of 
this thesis is composed of a sinezle iS8C 684 Cardcage and 
three (3) iSBC 614 Cardcages which allow a total of 16 
circuit board slots. These cardcages comprise a backplane 
assembly that conforms to the Intel Multibus specifications 
and provides slots for both Mutibus master and slave boards. 
The master slots are odd-numoered and the slave positions 
are even-numbered for easy reference. 

A master board is one which is capadle of acauiring and 
controlling the Multibus, while a siave board can only de 
referenced >by commands on the Mniltibdus (pe cue memory 
expansion voards). The iCS-&@ Chassis can de used with 
Taster boards operating in either a serial or parallel 
priority resolution scheme. In the serial mode, Multibdus 
access contention is resolved by the board placement within 
the cardcage. However, an external priority resolver 
network is required to implement the parallel priority 
scheme. In this implementation, a random priority network i 
emmeeecO)6Carlbiltrate tne contentions for the Multibus. Most 
importantly, one of tne above priority resolution schemes 


must be implemented or the interaction among the iSBC boards 
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an Voeecardceres © will mot be correct. For firtne r 


information consult References 9, 123, and il. 
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eee INITIAL EFFORTS 
1. Program Development System 

Duritves the initual stages of this tnesis, it was 
planned to expand the work done by Hicklin and Neufeld (Ref. 
2} to incorporate the REMEX Data Warehouse nemory storage 
unit. They nad developed a reconfigurable ‘table-driven 
CP/M-G6 BIOS that supported the MBB-8@ B3ubdd1-Board and the 
Peeel iicG2 double~density floppy disk controller. It was 
initially believed that other I/0 peripheral devices could 
pe Casily included in this BIOS with a minimum of effort. 
Within the proposed development system, the MBEB-80 would 
serve as the principal storage medium for newly designed 
programs and would provide an easy Method of booting FEicklin 
and Neufeld’s CPM.SYS within the iCS-S@ chassis. 

Eowever, this development strategy had several 
deficiencies. Ut Zine this hardware/operating system 
configuration, program development would be limited to the 
MDS or iCS-E&O systems and the CPM-&6 utility programs which 
they supported. Presently, the only compatible text editor 
available Poems Vedi tOre aistrinured | ay Die iad 
Mmeeearch, EL.CMD. This editor is very primitive, extremely 


Mera to use, and completely unsatisfactory for extensive 
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program develooment. Therefore, an alternative development 
system was required. 

It was decided to use the WORDSTAR text editor on 
the MP/M Multi-user System to create the needed software 
programs. This system provided several advantages over tne 
Mie, system. First, WCRDSTAR offers functions which would 
Significantly increase productivity and allow errors to de 
gGuickly corrected. Second, M?/M-compatiole versions of ASM- 
E6 and GENCMD utilities would enable programs to be written, 
assembled, corrected, and converted into executadle OMD 
feees prior to their transfer to the bubble memory. Third, 
Since the MP/M system is a multi-user system, it did not 
present the availability problems associated with the 
Single-user systems sucn as MDS. 

Olitimately, this software development scheme also 
vroved to be unsatisfactory, as numerous steps nad to de 
taken to move an assembled program from the MP/M system to 
the MBE-&2 board. Since only MP/M and MDS single density 
diskettes were compatible, assembled programs first had to 
be transferred from the MDS single density system to the MDS 
double density system using the laboratory utility program 
SDAFER.COM. This required that the MDS double density system 
be configured with an Intel &@&8 processor. Once tne 
program was transferred to a double density diskette, tne 
MDS double density system had to be reconfigured for use 


With tne MBB-&z2 bubble board and an iSEC &6/12A. After 


reconfiguring, the program could now be transferred from the 
double density diskette to the bubble memory. At tnis point 
the MBB-80@ was physically moved to the iCS-8@ chassis. 
Finally, the operating system could be loaded and the 
program @xrecuted under DDTE6. 

Besides being time consuming, the aodove process 
monopolized much of the laboratory ’s equipment. Tiasoe" Bice 


the equipment needed to make the transfer was i 


use, 
program else) CONld net be Carrieéde = out. However, 
initially, it was the only method available and therefore 
had to be employed. 
e. Verify M33-82 Operation 

The objective of this section was to verify the 
Meeper operation of the CPM.SYS developed by Eicklin and 
Neufeld. The double density MDS system was configured with a 
single iSBC &6/124A (#1), the MBE-E&E bdudbdle memory, and the 
izO2 Floppy Disk Controller. The system was successfully 
booted Prom mute woo, o Monitor in’ accordance with tne 
procedures given in Reference 1i by executing the command 
GFFD4:0. However, the bubble memory could not ve accessed 
Moree any of the CP/M built-in commands. After inspection 
Of the BI0S, it was evident that the final version of the 
CP/M-&6 Pe@oew==submitted dia not support the MBB-&C. 
Therefore, the CPM.SYS nad to be reconstructed. 

The files DKPOM.DEF and CCONFIG.DEF were first 


checked to ensure taat tne desired hardware configuration 
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was accurately reflected in the Disk Definition Tables, the 
Disk Tables, and the Bubble Tables. Once this was completed, 
the file MBBIOS AGG was reassembled and was toen 
concatenated with CPM.H86 using PIP.COM. The resulting nex 
fee Was then converted to an ex@€cutable CMD file and 
renamed CPM.STS. 

To ensure that ali possible errors were avoided 
Mer.oOr to syStem initialization, it was decided to reformat 
Poe MEB-EY. The program MBcOPMT.CMD was ex@cuted, inserting 
8d0Ch as the MBB-88 controller base address. Once 
formatted, the CP/M Toader program MB8SGLDR.CMD was placed on 
merees © and it of tne MEB-&g utilizine the LDCOPY.CMD 
utility. The reconstructed system was booted and functioned 
normally. 

S. Modification of the B10S for Use in the ics-s2 

As envisioned in the program development process, 
new programs would be transferred to the MDS double density 
system using a laboratory utility program. These programs 
could then be placed on the MBE-&¢8. The MRE-&% would then 
have to oe physically moved to the iCS-&2@ chassis. By 
entering the command GFFD4:4, CP/M-86 could be booted and 
the programs executed under CP/M or UDODTS6.CMD. FHowever, 
Since the MBB-&@ would ve the sole memory storage device in 
the iCS-83 chassis, a new modified 3105 aad ito de 


Soerstructed. 





The changes that needed to de made were located in 
two major areas of the BIOS. First, the file DKPRM.DZEF which 
contained the disk definition statements Por each logical 
CP/M disk drive had to changed. The number of logical 
devices was changed to 1 and the disk definition statement 
for the MBB-&S@0 was entered as CP/M logical drive 8 (Drive 
A:) indicating that the MBE-€@ was tne only “drive” in the 
system. The other changes were made to the Disk and 3udbdle 
map.es contained in the file CONFICG.DEF. fFicalin and 
Neufeld had created these tadles to identify whether C?/M 
logical drive numbers where either MBB-8@ devices or i2éd2 
eontrollers. These tables would Support any hardware 
configuration of MBB-8@°s and i282 contollers up a total of 
16 disk drives (maximum for CP/M). Eowever, otner peripheral 
devices such as the REMEX Data Warehouse could not be 


Supported as was initially believed. 


txd 


Once these changes nad been made, tne ICS was 
reassembled and used to create a new CPM.STS which was 
placed on the bubble memory. It was subsequently tested and 
it functioned normally. 
4. REMEX Low-Level Routines 

VOMCURRENTI¥ With toe wort on the M33B-8¢,  lowelevel 
read/write routines were written and executed whicno accessed 
the REMEX Data Warehouse memory storage unit. This work was 


accomplished on the iCS-88 chassis using an iS3C 86/124 


Single board computer and the REMEX Multibus Interface Card 
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Assembly. At first only the most primitive operations were 
performed, since there waS no permanent memory in the 
system. Using the $57 Monitor program, small programs were 
executed to examine the various values contained in the 
interface status registers. Once the new MBB-&S@ CPM.SYS was 
available, more comprenensive programs were written which 
could Duild command packets, Vedi smn COmmand ~pac<et 
addresses to the interface dDoard, and checx tne packet 
meas word for function completion. The basic logic of the 
read/write functions was discussed in greater detail in 
Chapter 3 and the logic diagram is snown in Figure 4.1. 

A command packet was built which would write a very 
Simple set of characters to a particular Nead, traces, and 
Mecevor numver of the REMEX bard disk or a tracz and sector 
number on the floppy diskette. Usine DDTSE6.CMD, the commana 
packet was then altered to produce a read operation which 
would retrieve the previous message from the RDW and write 
it to a selected memory address. PDT&6.CMD was also 
extensively used to monitor packet construction and memory 
Gmmtent. With each successful transfer, larger blocks of 
data were transferred until it was concluded that tne 
operations were vbeing correctly performed. Althouen some 
progress was Made, the program turn-around time resulting 
from the lacx of an ad€quate development system definitely 


impeded further progress. 
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Figure 4.1 
RDW Read/Write Logic 
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The development mechanism that nad been used up to 
this point was tedious and time-comsuning. The time 
required to fYrepair errors discovered while working on the 
iCS-80 was too excessive to support cohesive program 
modification. It also became evident that the concepts used 
py Hicklin and Neufeld in the development of their BIOS were 
Mot sufficient to meet the objectives of this thesis. 
Although it was presented as a model fora very flexidie 
system, the BIOS actually only supported MB2E-E Ddbubble 
memories and i292 floppy diskette controllers. Inclusion of 
additional peripheral devices would have required major 
mMeartication to the 38103. Furthermore, even if these 
modifications were madé, each time a device was added or 
deleted from the system, the code within the BIOS for the 
Individual function calls would have had to be changed. fhe 
many inconveniences of the program development procedure 
coupled with tne limitations of tne Hicklin and Neufeld 
approach ina varying hardware environment necessitated a 
new BIOS design strategy. 

Hammond (Ref. 3] had identified that certain device 
specific code could be extracted from the core of the BI10S 
without affecting function operation. This was accomplished 
Beeoaairectiy vectoring BIOS calls to the proper subroutines 
via a taole of labels. Hammond had extracted the R38AD, 


Bits, and CVieeslOsserunculons ‘and constructed the 
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appropriate tables ina separate file named CONFIG.DEF. 
This file was then assembled with the BICS by means of an 
"include statement. 
Next, let us examine the READ function in greater 
detail to see exactly how this BI0S works. Figure 4.2 
contains the code for the READ function in the core  BI10S 
for a hardware configuration consisting of an i2¢1 Floppy 
Disk Controller. 
read: 


FOr wn xx 
mov bl,unit 


add Ox,bdx 
call readtdl [bx] 
reg 


Figure 4.2 
Tabdle-Driven BIOS Read Code 

This controller supports two floppy dis& drives 
meen correspond to CP/M logical drives @ and 1. This 
correspondence is set up in the Disk Definition Tables. Also 
@m@eor to the 383D0S call to the S810S &BAD function, the 
desired drive number has been stored in a B8I0S variable 
fied unit . The value of unit is first placed in the 
"pl register. Next, it is doudled since each label in the 
Meira ble represents the 16-dit address of the device- 
specific read functions. A call is now made to tae 
read_table using the offset contained in the “bx register. 
This table entry then indirectly addresses tre appropriate 


Subroutine for the desired unit. For example. if CP/™ 
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W@eical drive 1 (B:) is selected, he = feacd © Cail is 
indirectly addressed to the subroutine ilabel located at an 
offset of two (2) in the read_tabdle. The read table is 
shown in Figure 4.3. Notice that since both CP/M logical 
G@amves are floppy disk drives, tne read call is vectored to 


the same subroutine. 


meqatol aw OffSet i2zgl read 
dw offset i291 read 


Figure 4.3 
BIOS Read Table 


Through tueweuse SOf 2a. itanle-driven > 2105 , the 
configuration flexibility needed for this application could 
be achieved. The use of the indirect call allows all device 
specific code to be isolated in a single file. Therefore, a 
separate file can be constructed for each unique perivheral 
device and can be included in the BIOS by tne use of the 
“include assembly command. An additional benefit of this 
type of approach is tnat it allows for the systematic 
Smeaton or deletion of hardware devices to or from tae 
system witnout disturoding the basic 3105S code. 

The tabvle-driven concept also proviced an improved 
program develpment scheme and a more logical approach for 
the implementation of the REMEX Data Warehouse memory unit. 
dJammond had previously written tne code to support the Intel 


meot Floppy Disx Controller. A spare i2@i1 controller was 
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available and was placed in the iCS-8@ chassis. With a few 
minor modifications to the BIOS, it was operational in a 
very short time. Since both ALTOS and MDS single-density 
diskettes were fully compatible, programs could now be 
written, assembled, ard converted to executable code and 
then be taken directly to the iCS-&® for execution. This 
reduced the amount of time needed to correct errors or 
modify a program and gréatly facilitated code generation. 
Because devices could be added to the BIOS 
independently, it was decided to utilize the i231 floppy 
disk drive as a developmertal aid and to subsequently 
implement the REMEX floppy disk first followed by the hard 
fee, the MBB-@9 would be sudstituted for the icvgi once the 
REMEX interface was completed. This implementation scheme 


is explained in more detail in the following sections. 


3. INTERFACING THE REMEX DATA WAREHOUSE 
1. Floppy Diss Drive 

During tne Cestine of tHe initlal REMEX Rf2AD/WRITE 
low-level routines, it was observed that the REMEX would 
only intermittently complete a packet operation. ween ~ At 
did not complete successfully, the program looped infinitely 
checking the packet status word (see Figure 4.1) for a value 
other than azero, indicating that the REMEX had either 


completed the operation or that an error had occurred. when 


multiple packets were sent out on the Multibus, completion 
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codes were occasionally returned in the command packet 
Status word. When DDT86 was used to trace through the Read 
routine step vby step, the same results were obtained. 
However, this procedure did verify that command pacaets were 
being constructed properly and that the packet address was 
being transmitted to the Multibus correctly. 

Next, a Multibus Monitor Board was used to observe 
the action on the Multibus and confirmed that all data was 
correct. This led to speculation that either tne interface 
board was not transmitting the correct information to the 
REMEX or the REMEX was not processing packets correctly once 
it received the information from the interface board. 
However, further hardware testing revealed that both tne 
REMEX and the Interface were functioning normally. 

The source of the vroblem was found more by accident 
than by design. Documentation [Ref. 8: p. 2-4] indicated 
that the Interface Assembly would wait from € to i5 host C?7d 
cycles between consecutive DMA operations. The exact number 
of cycles can be jumper selectable by the DMA Throttle. 
Therefore, polling the packet status word for a completion 
code was thought to provide sufficient CPU cycles to allow 
the process to continue. However, when the wiring diagram 
of the Interface Card Assembly was examined, it was 
discovered that the DMA Throttle was controlled by the 
momoer of Multibus cycles and not by the number of CPU 


cycles. Since the Throttle was set to the factory default 





position, one additional Multibus cycle was required before 
the interface board could execute its next DMA operation. 
Because there was only a single host computer in the system, 
no additional Multibus accesses were made. This explains 
why marginal success was odtained by sending multiple 
pac xets since this provided the additional Multibdus 
accesses. The DMA Throttle jumper was removed which allowed 
the Interface Card Assembly to respond immediately with a 
Dmea operation once it acquired control of the Multibus. 
Subsequent packet operations were successfully completed. 

Once the READ/WRITE driver routines had been 
debugged, tre next step in the floppy disk implementation 
was to incorporate these routines into the table-driven 
BIOS. A separate ‘include file called RXFLOP1L.AEE was 
established to contain the necessary device-specific 
subroutines. OM the Seven BH0OS functhonus thet had to de 
addressed, only the READ and WRITE functions required code 
in addition to that contained in the basic BIOS routines. 
mach of the other functions were returned directly to tne 
marn “BIOS. 

The command pacxet was allocated memory space in the 
data section of RXSLOP1.AG6. However, tne packet parameters 
meee to ove supodlied from the B810S variables in order to 
access the #ile requested by the CP/M file manager. Figure 
4.4 depicts the READ packet for tne ReMEX floppy disk drives 


used in this implementation. 
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Figure 4.4 
REMEX Floppy Disk Read Pacxet 


Hrom  “Ghamuer 5, @ir@call that werd 0 of the command 
pacxet is composed of a modifiers section, function code 
Ylock, and unit id number. The value of 19h in the modifiers 
section merely indicates that a single packet is being sent 
and that all automatic error routines are in effect. The 
function code block (1) specifies a READ operation. Since 
the REMEX floppy disKk drives were chosen to be equivalent to 
G@evweelogical disk drives 1 and 2 (3B: and C:) for tnis 
mpwementation, the CP/M drive number and thle REMEA’ unit id 
for the two floppy disk drives were equivaient. Therefore, 
the desired CP/M disk number is directly inserted into the 
packet. The 16 -bit BIOS variable “track wnoich contains the 
requested track number is placed into word 2 of the command 


packet. Word 3 which contains the nead and selected sector 





number is formed by inserting a zero in the upper byte 
indicating that the floppy diskette will only be addressable 
on a single side and placing the BIOS variabie sector in 
the lower byte. The 2é-bit address of the CP/M DMA buffer 
which will receive the requested data is computed from the 
DMA base and offset. The extended address bits (bits 16-19) 
@re entered in the lower byte of word 5S. For example, if 
the local memory of an iSRC 86/12A is configured to respond 
to Multibus memory segment zero, the extended acdress bits 
will be equal to Oh. However, if the local Memory were 
configured to respond to Multibus memory segment 18000, then 
the extended bits would be Gln. The remaining i6-bit address 
is placed into word 4 of the command pacxet. 

WOrd wo wawen cOntalns thew transfer word count caused 
the most problems with the floppy disk interface. The major 
difficulty encountered was the diréct result of poor and 
misleading documentation. The REMEX technical manual for 
the interface board indicates [Ref. 8: p. 2-4} that the 
REMEX can selectively transfer data to the host computer in 
sueemer GS—bit or 16-bit words by setting a single switch. 
Since CP/M works with S-bit words, the switch was set 
accordingly and a transfer word count of 12& 8-vdit words was 
placed in the packet and sent to the REMEX. At “ours: te. CHS 
Seemed tO work correctly because a directory of the diskette 
was read without difficulty and files could be transferred 


to and from the diskette without error. dowever, problems 





were encountered wnen attempting to execute a file that was 
on the diskette. An error message of FILE NOT FOUND” was 
displayed intermittently. If a file was found, the program 
would not execute correctly. In poth cases, the system 
partially crashed ae no other operations Could be 
accomplished, despite the fact that the prompt character 
Continued to function normally along with an occasional 
error message. 

The source of the problem was not readily apvdearent. 
The operating system worked correctly until the directory 
of the REMEX floppy diskette was obtained or a file was 
executed. However, no error code was dveing generated ody 
the REMEZ. In fact, the success code that was being 
generated indicated that the operation and data transfer was 
Bemere correctly accomplisned. &xecuting the routines using 
DDT &6 also indicated that tne REMzEX was fine) youn 
correctly and showed that the data was being placed in CP/M 
DMA duffer. 

Numerous changes and experiments were made 
attempting to locate the cause of this problem. Pranvvouus 
of the diskette’s directory were odtained without error. 
Hardware was tested and retested with negative results. 
Finally, a memory map of the operating system was printed 
memer Obtaining the directory from a diskette in the MDS 
Single density disx drive system. LAL S= wads ecOmMecaneaet 0 <a 


memory map of the operating system after the directory of 





the same diskette was taken from the REMEX floppy drive. It 
was here tnat the error was uncovered. The REMEX was 
transferring 256 8-bit words into the DMA buffer space, not 
the 1285 S—bit words as believed. Thus, the extra data was 
overwriting portions of the CP/M-86 BIOS causing the system 
Poms partially crash. The problem stems from tne fact that 
the REMEX wants to Know how many 16-dit words it should 
transfer. This is cempletely independent of how the REMEX 
will transmit the data. Therefore, since a CP/M sector of 
128 bytes is equivalent to 64 or 4dh 16-‘it wores, 40h was 
placed in word 6 of the command packet and no further 
pegolems were encountered. 
2. Hard Disk 

Although the implementation of the hard disk was 
very similar to the floppy disx drives, there were some 
notable exceptions. First, the ReEMEX had a sector size that 
Was a multiple of the standard CP/M sector size of 128 
oytes. This necessitated the use of A sector 
blocking/deblocking routine to resolve this disvarity. 
Second, since the REMEX hard disk has four (4) separate 
heads, the question of how to divide up the disk had to de 
resolved. The most logical and straigntfoward method was to 
let €acn head represent a separate CP/M logical disx drive. 
Bach drive would then be able to address up to 4.5 megadytes 
of data. With these ideas in mind, the hard disx interface 


was begun. 
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Changes had to be made to the Disk Definition and 
Gomftieuration Tables. In the file CPMMAST.DEF, CP/M logical 
drive numbers 3, 4, 5S, and 6 were added to the table. Fach 
drive number had a disk definition statement that described 
the physical storage capabilities of? a single nead of the 
hard disk. The disk definition variables were determined as 
presented in Chapter 3. Now, the BIOS would support a total 
of seven (7) peripheral 1/0 devices: an i2@1 floppy disz 
drive, two RSMEX floppy dis drives, and four REMEX hard 
disk drives. Later, the MBB-39 bubble memory would be 
substituted for the i2@1 disk drive. Also, additional 
labels had to be added to the tables in the file CPMMAST.CFG 
to vector the BIOS function calls to the appropriate 
subroutines located in the include file RXHARD1.aAé6. 

(cmos ye Glirieuit obSvacle to Overcome in this 
portion of tne implementation was to determine the HREiMEX 
Dard disk sector size. The sector size can de either i223, 
256, 512, or 1824 bytes. Initially, attempts were made to 
Bemormat the hard disk in accordance with Reference 7. 
Switches S1 and S2 located on the Formatter II Card Assemoly 
were set to configure tne hard disk with a 512 byte sector 
Size. A program was then written which built a command 
packet to execute the REMEX built-in formatting routine 
[Ref. 7 : p 3-23]. However, repeated attempts failed to 
produce a successful format operation. The REMEX also 


Supports a built-in Maintenance program that tests the FEard 
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Disk Format operation. When this program was run, multiple 
enrioerT Wescaces were returned indicating that the format 
program was inoperative. 

Since data had been written to and retrieved from 
the hard disk during lOw-level driver testing, it was 
obvious that the REMEX had been previously formatted. The 
next step was to determine exactly wnat format was used. 
This was not as easy as might be expected. During the power 
up sequence, the REMEX will check the sector size switches 
and configure its internal circuitry to process sectors of 
that size even if the switch postions do not represent the 
merual) format of th@*hard disk. That is precisely why these 
Switches must match the actual physical sector size in order 
more read/write operations to work correctly. This fact 
caused consideraodlée confusion in the interpretation of tne 
error messages Obtained by attempting to access the border 
SEeevors (1¢4, 67, 39, and 21 for sector sizes of 128, 256, 
512, and 1024 bytes respectively). However, it was finally 
determined that the sector size was 512 bytes. 

Since the REMEX sector size was a multiple of the 
128-byte CP/M sector size, a sector bdvlocking/debdlocking 
routine was needed to coordinate the access of CP/M sectors 
atm the physical sectors of the hard disk. In this case, 
there were four (4) CP/M sectors contained on each hard disk 
sector. On each EBIOS call, the CP/M-S6 BDCS ixcludes 


information that can be used to provide effective sector 


Or’ 





blocking and deblocking. The sector bdlocking/deblocking 
routine used in this implementation is distributed by 
Digital Research in skeletal form [Ref. 6: p. 70]. 

The blocking/deblocking algorithms map all CP/M 
sector read and write operations through an intermediate 
pueeer called hstbuf . The size of this buffer is 
equivalent to the REMEX sector size (512). During a read 
Operation, a Sle-bvyte sector of data is read into the 
“astbuf or nost buffer from the REMEX hard disk. Since the 
host buffer now contains four CP/M sectors, the desired i28- 
meeve sector is obtained by correctly offsetting into the 
meat cuffer. This data is then transferred to the CP/M DMA 
puffer defined by the UMA base and DMA offset variabdles. 
Sumtlariy, during awrite operation, four CP/M sectors are 
amemeoven to the host buffer. The data is then transferred to 
the REMEX nrard disx and stored on a single Sle-byte sector. 

Mot din (te vL10CKing/deblockKing Proutine itself, the 
values and variables which relate to CP/M sectors are 
prefixed by ‘Sek , while those related to the RSMEX hard 
disk are prefixed by hst.. The SFLESK, S=ETTRK, SETSEC, 
SECTRAN, and SETDMA entry point routines were transposed 
into the REMEX noard disk “include file. These subroutines 
Store values for later use and SsxcTRAN transiates CP/M 
see@vor Values into the corresponding physical sector. fhe 
READ and WRITS entry point labels were placed in the 


mead table and write table respectively, while the actual 
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REMEX hard disk read and write low-level drivers were 
incorporated at the READSST and WRITEHST entry points. 

Toe command packet was constructed fror the 
following variables: hstdsk which represents the host disx 
number, hsttrk which is the host track number, and 
"hstsec. which cooresponds to the host sector. The host disk 
number is transformed into the appropriate head number and 
ime sentverec into the upper byte of word 3 of the command 
packet. The memory segment and offset of the nost buffer 
(hnstbuf) is translated into a 20-bit address. The extended 
bits (16-19) are entered into the lower byte of word 6, 
While the remaining 16-bit address is placed in word ¢4¢ of 
the command packet. For the REMEX hard disx, we want to 


Meanster 512 bytes or c5S6 16-bit words. Therefore, the 
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Figure 4.5 


REMEX dard Disk Read Pacxet 





transfer word count (word 6) was Set to 1¢¥h. The REMEX hard 


disk Read packet is shown in Figure 4.5. 
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that supported the MB38-88 bubble memory and the REMEX Data 
Warehouse floppy and hard disk drives. The original master 
iSBC S6/12A (#1) was booted from the MBB-S2 and had its 
Onodcard memory switcn-ard-jumper selected to be accessible 
from the Mulitibus beginning at memory segment zero. Data 
meapsferred from the REMEX would be put directly into the 
meer DMA or Host Burfers via DMA operations. The next step 
moe tO «€©6introduce a second iS8C 86/12A into the system which 
would also utilize the CP/M-86 operating system. 

it was decided to use the 32x common memory to nold 
a bootloader program that coula de usea by the slave iS3C 
PerpteA Computers to boot the CP/M-&6 system. A utility 
program, LDCPM.AS6, was written to place a copy of CP/M-s§ 
mo, common memory which was especially configured for the 
Slave computers. A second utility, LDOBOOT.A8E, was used to 
transfer a copy of the bootloader program (BOOT.AG&6) into 
common memory. The resulting common memory Map is snown in 
Figure 4.6. CPMSLAV&.CMD was identical to the CP/M-c6 system 
used for the master iSEC 66/12A except that it supported an 
iSBC 86/i2A wnose local memory was accessible from the 
Multidus pveginning at memory segment i@@@h. When initiated 


from the iS3C 86/12A monitor, the bootloader program would 
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Common Memory Map 


transfer the CP/M-86 slave system from common memory into 
local memory beginning at 48:6@0@00n0. Cnce tne transfer was 
somolete, control would be passed to the 3105 to initialize 


toe system. It muSt noted that all these programs must 


This scheme, although utilizing the DMA capability 
of the REMEX to the maximum extent possible, would require 4a 
different CPMSLAVE.CMD file for each iSBC E€6/i2A added to 
the system. Each computer’s local memory would have to be 
Placed in a se@parate 64K block within the one-megabyte 
address space available to the Multidus and these page 
numbers would be have to be entered in tne lower byte of 
word 5 in the command packet. This organization is somewhat 


awkward and exhausts a large portion of common memory if 
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several computers are used. Therefore, amore acceptable 


alternative was needed. 


' ©. SYNCHRONIZATION AND PROTECTION 


1. Synchronization of Read/Write Operations 

With two active iSRC 86/12A computers in the system, 
the synchronization of read/write operations had to bve 
addressed. Since the REMEX could queue up to eight (8) 
command packets internally, it was initially felt that this 
feature would provide adequate synchronization of the I/0 
requests from the independently operating Computers. 
However, when simultaneous multiple transfers were attempted 
between the CP/M hard disk logical drives, sporadic errors 
occurred. InSpection of the READ and WRITE routines in tne 
hard disk “include file (RXEARD1.A66) revealed that there 
wae nothing to prevent a clash of both iS3BC B3E/12A cormouters 
if they simultaneously attempted to send a command facket 
address to the REMEX Interface Card Assembly. Since the 
packet addresses were sent in three (3) single-syte Multibdus 
transfers, it was indeed possible for the values sent to the 
interface board to become intermixed. Also, once the most 
Significant byte of tne packet address is sent, the 
interface immediately signals the REMEX that tne packet 
address is complete and ready to be transferred. However, 
thiS may not ve the case. Consider the case where computer 
#1 has transferred the extended address and the least 


Significant bytes of the packet address to the Pacxet/IMAa 
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Remister. Computer #2 then sends the extended bits of its 
packet address. Since each computer’s memory begins on a 
different page, the extended bits will be different for each 
iSBC 86/12A. Computer #1 now regains control of the Multibus 
and sends its most significant address byte. The Remex will 
now read the packet located in computer #42°s address space 
rather than the packet in computer #41°s address space. This 
will certainly cause severe problems. 

Initially, the section of code used to send out the 
packet address was identified as a critical section. A 
semaphore was then defined to control the access to the 
critical section. In order that all active iSEC &6/12A 
computers could have access to the semaphore, it was placed 
in common memory and coulc take on a value of either ¢€ or i 
indicating that the resource was either busy or free 
respectively. If it was a 1, tne requesting computer would 
set it to 3, send the three bytes of the packet address, and 
then reset it to 1. If the reaquestor found that the 
semaphore was equal to @, it would delay and then recneck. 
This checking process was implemented using the LOCK XCHG 
instruction to provide exclusive use of the Multibus. 

when simultaneous multiple file transfers were again 
attempted, errors still occurred indicating that there was 
still some interference on the Multibus. This probabiy 
occured wnen the registers of the interface were set up for 


a DMA data transfer and a packet address was then written 





into the Packet/DMA register before the data could bde 
transfered. At any rate, amore inclusive synchronization 
scheme was required to ensure that a single iSBC E&6/12A 
read/write operation could be completed without encountering 
contention from the other computers in the system. 

Since it was desirable to have all iSBC &6/12A 
computers configured alike, it was decided to adopt 4 
software approach to the Synchronization problem rather than 
the conventional monitor approach. The method cnosen was 
based on sequencers and eventcounts [Ref. 12]. This method 
is modeled after the “ticket/server. system used in many 
stores where services are performed. When the customer 
arrives, ne takes a numbered ticket and then waits toc 208 5 
number to come up before being served. The server works in 
tacket number order. The implementation of tnis scheme is 
very straightfoward and nad been previously used by Hammond 
[Re?f. 3]. Two 16-bit counter variables, ‘ticket and 
“server. , were placed in common memory. The value 2 was 
reserved for the ticket number indicating that another 
computer was presently modifying the ticket number. 
Exclusive access to the ticket number was provided by the 
LOCK XCHG PAStrucuLon. A alzoritnomic language 
representation of the sequencer routine is given in Figure 
4.7. The delay used in the Await Subroutines was used to 
prevent Multibdus contention. Request is called prior to 


eacn read or write operation to gain e@xclusive access to the 
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Primitive Subroutines 
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ticket: sreturn a ticket number 
customer no. = ticket no. 
lence-t tceet 00. 
ret 

await: 7d@lay until customer no. = 


;server number 


while customer no. < server 
delay 
ret 
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advance: sinc server 


ince server 
ret 
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request: ;get resource 


Carl ticxet 
Call await 
ret 


release: srelease resource 


call advance 
ret 


Figure 4.7 
sequencer Algoritnm 





shared resource. Once the operation is complete, release 
is called to free the resource” by increm@éntine the server 
number which allows the next 1/0 function to = get. executed 
When the sequencer code was implemented into the read/write 
routines for each of the peripheral I/O devices, ano further 
errors were noted. 
2. Common Memory Read/Write Routines 

As alluded to earlier, the CP/M-86 BICS which uses 
DMA operations to transfer data between tne iSB8BC &6/12A 
computers and the Remex Data Warehouse requires a unique 
BIOS for Sach computer in the system. This places a severe 
limitation on further system expansion and complicates the 
system configuration control requirements. Futnermore, this 
type of implementation requires that at least a portion of 
the iSBC &6/12A°s local memory %e accessible to the 
Muitibus. One of the principal goals of this thesis was to 
provide a system in which all computers were isolated from 
One another. Obviously, this implementation does not support 
this goal. It also results in an awkward bootloader 
arrangement in common memory and requires that all versions 
of CP/M-@6 needed for system operation be accurately updated 
Should any changes or modifications occur. Threrertore, ~a 
more acceptable BIOS implementation had to be found. 

The resulting implementation routed all data 
transfers through a common memory buffer. The size of this 


buffer was set to correspond to tae largest physical sector 
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Figure 4.8 
Common Memory Read Operation 


Within the system which was the 5le-byte sector of the REMEX 
nard disk. The additional code required for each read/write 
routine was minimal since its only function was to transfer 
a given amount of data detween local and common memory. A 
data flow diagram depicting a typical read pete from 
the REMEX is shown in Figure ¢.5. For illustration, consider 
aeecr/M initiated read operation from the REMEX hard disk. 
The command packet will de constructed as before except that 
the 26-bit common memory buffer address will replace the 
host buffer address in word 4 and tne lower byte of word 5 
of tne packet. This will result in the desirec data being 
read into the common memory buffer. When this operation is 
complete, the requesting iSBC S56/12A will then transfer the 
data in tne common memory buffer to the aost buffer located 
mame Gata section of the Cr/M 3I0S. This procedure is 
entirely transparent to the CP/M EBDOS. <A write operation is 
Pegeearly completed. first, the data in the host buffer is 


written to the common memory buffer. Next, a packet is sent 





to tne interface whicn transfers the data from common memory 
mema specified head, track, and sector of the hard disk. The 
required changes were made to the “include files mor Sue 
MBB-88 budble memory, the REMEX Ploppy disk drives, and the 
REMEX hard disk drives and the files were renamed 
MBE@DSK.A@6, RXFLOP.AGE6, and RXBARD.A&SE respectively. These 
files appear in Appendices C, D, and KE. 

The common memory routines producec several 
improvements to tne overall system design. First, ail iS3¢ 
86/124 computers could be completely isolated. Each of the 
four computers used in the system was jumper configured s5so 
that all onhoard memory was reserved totally for local cCP?PY 
Meemmand Could not be accessed from the Multious. This 


provided the required protection for each computer’s local 
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Figure 4.9 
Common Memory Allocation 





Memory. ceconad, only a single copy of the CP/M-86 operating 
System was required for all of tne slave computers since 
data transfers were locally initiated. In fact, the only 
difference between the slave and master versions involved 
the initialization of the synchronization variables and the 
log-table. A memory map showing the configuration of common 
memory is presented in Figure 4.9. 
Oo. Disk Write Protection 

The ticket/server synchronization routine ensures 
trat Single iSBC @6/12A read/write operations can de 
completed without interference. However, Ti. See Se 1 Ot 
Sutipeaent to provide the necessary write protection to the 
Shared devices in a system of multiple computers each 
running CP/M-&6. Consider the case of two processors trying 
to write to the same CP/M logical disk. CP/M reads the disk 
Memectory and constructs an allocation vector in the BIOS 
beat indicates the lee@ical blocks on the disk that have not 
beenmewritten to previously. zaco iSBC S6/12A then proceeds 
to write its data file to the unallocated blocxs in 
sequential orier. Although the individual write operations 
meres Syncnronized, the result is still overwritten and 
garvdled data. Therefore, tnlis implementation institutes a 
read/write strategy that allows all computers to read data 
from all the shared devices Dut only write to a single 
device to prevent files from being overwritten. Moreover, 


it was also desirable to be able to seléct any of the shared 
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devices for write operations from each of the four system 
console positions. 

A logon and logout procedure was developed to 
control the write access to the various peripheral devices 
through the use of a tadle located in ccmmon memory. This 
table has a entry for each device in the system (Figures 
4.12 and 4.11). Before the user is permitted to doot 
babe CP/M he is askéd for his console number and the CP/™ 


drive that he wishes to log onto (write to). The CP/M drive 


logtbdl (MBB-@0; FLOP | FLOP2]) GARD1 | GARD2;cARDS{EARDS | 
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Figure 4.12 
Login Table 
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Figure 4.11 
Final Common Memory Configuration 
number is stored in a local variable called “user which is 
used a5 an offSet into toe log table. The log tabdle is then 
checked to determine if the desired disk has already been 


logged onto. Tf? not, the console number is entered into the 





ame table at an offset corresponding to the given device. 
Ctherwise, the user is asked to select another disk. To log 
out, the user types the command logout which places a zero 
(free) in the log table at an offset equal to the user 
number. Each CP/M logical disk drive requires its own copy 
of the log out routine (LOGOUT.CMD) so that it can de 
executed from every disk drive. 

Wi Coan the B108, when a write operation is 
requested, the variable ‘user is compared to the CP/M 
logical disk number. If they are equal, the write operation 
is permitted to continue. If not, tne user is informed that 
write operations are not permitted to that disx drive. This 
guarantees tnat no two iSRBC 86/12A computers can write to 


the same shared disk. 


D. SUMMARY OF SYSTEM GENERATION 

The following cescriptions provide step-by-step 
procedures on how to create the BIOS for this implementation 
of the CP/M-&6 operating system, how to step up the MBB-2g 
bubble memory board in the MDS double density system, and 
now to start up the multi-user CP/M-E6 system. 

1. System Bios Creation 

a. Develop separate files for each 1/0 device being 

sure to address the seven device specific functions in each. 
im this code, before any Multibus access include the 


command call request and upon completion of a Multibus 


access include tne command ‘call release . 
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b. Ensure that all I/0 iS accomplished vie the 
common memory [1/0 buffer which extends from Z¢€06:i1¢@ to 
E00@:3080. Develop a transfer routine for moving data to and 
from the common memory buffer and the host computer. 

c. Decide upon the logical hardware configuration 
as will be seen by CP/M-@6. Based on this configuration, 
develop the Disk Parameter Table which will be used as the 
source file for GENDEF.CMD to produce a .LI3° file. Aliso, 
Using this same hardware configuration and the {[/0 device 
files, develop the label tables in CPMMAST.CFG for the seven 
G@emece Specific functions. | 

d. In the BIOS use the ‘include command for all 
I/O device files, the label table (CPMMAST.CFG), and the 
Disk Parameter Table (CPMMAST.LIE). The files SYNC.AE6 and 
LOGIN.AGE must also be included, but require. no 
Meet ications. 

e. Assemble the BIOS using ASM&E6.COM. Using 
moteo.OMD may generate forward reference errors and require 
tae rearrangement of some included files in the BIOS. Two 
assemblies must be made. The first must be assembled with 
the master conditional assembly switch set to true in order 
to create the master BIOS. The second nust de made with the 
Switcao set to false in order to create the slave BIOS. 

tf. “SG@Oncatenate the resulting hex files with CPM.H86é 


meer omm CPMMAST.H86 and CPMSLAVE .HEE. sem omeeCr/MIuti tity 
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command GENCMD.CMD (GENCMD CPMMAST 8888 code[a4d]) to 
generate the executable command files. 

g. Transfer CPMMAST.CMD to the MBB-80 bubble memory 
Board as CPM.SI5. Transfer CPMSLAVE.CMD to drive 0D: of the 
REMEX. 

2. Setting up the MBB-e@ in the MDS Syste: 

a. Remove the Intel 8880 microcomputer ar t2e 
associated memory boards from tne MDS double density system. 

Doone wtmeriseG  GS6/12A° #1, place the switches 1-16 
moome-> On DIP switch Sl in tae closed position. Install a 
jumper between pins 127 and 126. If there are jumpers in 
place for the clock, pins 193 and 105, remove them. 

Ce wemscert the iss EC/i2A #1 and the MEB-EO@ board 
Meme THe YacKkKDlane into the MDS cnassis. 

qd. Turn the power to the MBS chassis and tne disx 
drives on. Once these devices are running, apply power to 
the MBB-83 board by setting the memory protect switch on the 
backplane to the “run position. Now, the CP/M-86 operating 
System can be booted from adouble density diskette ody 
entering tne command GFFD4:¢@. The system booted snould be 
one that is capadle of addressing the bubble memory as a 
tome te. 

e. To format the MBE-&8@ bubble memory execute tae 
program MBEO@FMT.CMD and use €@90F as the base address for 
Meeecontrolier. Execute LDCGPY.CMD using LDRMBE@.CMD as the 


source file. faistwill place tne load@r on tracks @ and 1 





of the MBB-88 bubble dDoard. Finally transfer CPMMAST.CMD to 
the bubble as CPM.SYS. 
3. System Initialization 

a. fosere four i556 S6/i2A computers into the ics- 
&f chassis. One computer must have a jumper on pins 1063/1904 
and 185/126. These connections supply the clock for the 
Multidus. All computers should have pins 112 and 114 
connected by a jumper wire. This ensures that fate 
computer’s local memory is inaccessable to ‘the Multidus. 
eo Or ali computers, only position 8-9 on DIP switch S$1 
should be closed. Ali other positions should be open. 
Finally, insert the M33-8d bubble memory board, tase 32k 
common memory board and the REMEX interface boarc into the 
Momee Chassis. 

Be. “2urn tre 1CS—50 power switch on. 

Cc. Power up the REMEX in accordance with Ret. 7 and 
turn the MBB-&Q memory protect switch to on. This switch 
is located in the rear of tne iCS~-8@ chassis. 

d. When the REMEX Rard disk has timed out and the 
ready light 15 on, enter the command GFFD4:4 from the 
Semsole attached to iSBC 86/124 #1 to boot CP/M-SE from the 
MBB-&0. The synchronization variables and the loge table 
entries will be initialized in common memory. 


e. Select drive D: 





ie 
load the 
EGOS 3:50. 

g. 
place the 
B@LE 24080. 

Jeu 


computer dy 


ihe 


Execute LDCPM located on drive D:. Dats wailed 


file CPMSLAVE.CMD into common memory starting at 


Zxecute LDBOOT located on drive D:. This wil 


file  BOOT.CMD into common memory starting at 


Now, CP/M-&6 can de booted on any iSBC 86/12A 
entering the command GFG@¢C:€400 from the monitor. 


When a session is completed, enter tne command 


LOGCUT to logoff the system. 


2. 





V. RESULTS AND CONCLUSIONS 

A. GENERAL RESULTS 

The ultimate goal of this thesis was to develop a multi- 
computer protected CP/M-86-based system that shared memory 
Storage devices. This goal was accomplished and the 
resulting code is located in the Appendices. Tae major 
product produced by this thesis is a completely operational 
multi-user development station. The CP/M BICS is completely 
table-driven and can be reconfigured for different hardware 
configurations in under twenty minutes. This feature alone 
is a Significant improvement over the standard BIOS marketed 
by Digital Research. In addition, it should be quite easy 
to e@xpand the current system to permit more users or add 
additional I/0 devices. 

The system provides user protection in several forms. 
No user, once logged onto the system can destroy, either by 
design or by accident, anothers user’s files or local CPU 
memory. rowever, any single computer can destroy common 
memory, but it is a simple matter to restore eee 
Furthermore, tne logon and logout procedures prevent two 
users from simultaneously logging onto and writing to the 


same CP/M logical disk drive. 





B. EVALUATION OF THE IMPLEMENTATION 

0 evaluate System performance, two tests were 
conducted. The first test involved assembling a 3K and then 
a 24K file with a single computer logged onto the system. 
The assembly time was recorded using a conventional 
Stopwatch. Next, two computers were used to Simultaneously 
assemble the same file, followed by tnoree and then four 


— 


Semputers. The results of the test are shown in Table 5.1. 


Tadle 5.1 
REMEX Assembly Times In Seconds 


FILE ONE TWO snd FCUR 
SIZE COMPUTER COMPUTERS COMPUTERS COMPUTERS 
OK i239 Lect iy pea Zens 
24k Fogle Gap & 246.7 7s) em PA he are, 

Page ~S<.2 
MP/M Assemodly Times In Seconds 
FILE ONE TWO THREZ FOUR 
Ze © USER USERS USERS USERS 
ok LES x x x 
24K OZone x x x 


One might expect that two computers would take twice as 
long to assemble the same program and three computers three 
times as long. powerver, “excent for the fnitial contention 
for the I/) devices, all computers could assemble the files 


feeeopardilel. This accounts for the fact that there is not a 


87 





linear relationsnip between the oaoumber of computers 
operating in the system and the assembly times. 

To provide a means of comparison, an attempt was made 
to run the same test under the MP/M operating system. 
However, MP/M would not permit more than one file to de 
assembled at the same time. In fact, on several attempts, 
the entire system crashed. The results of this test are 
shown in Table 5.c. 

The second test involved a file transfer utilizing the 
Mae oo Utility PIP.CMD. Since ali operations were 1/0 
intensive, this test represented a worse case scenario. The 
femst run consisted of transferring a 16K file witao only one 
computer operating in tne system and recording the time it 
took to complete the operation. Then two and finally three 
computers were used to execute the identical PIP command at 
the same instant. moe time 1G took for ali .vcompiters ‘to 
complete the task was recorded. The results of tnese tests 
are shown in Table 5.3. The “Xs indicate that it was not 
possible to make the transfer because there was an 
insufficient number of destination type devices. (i.e. Two 
computers cannot transfer files to a single bubble device at 
at the same time.) 

To provide a comparison for the above results, tae same 
test was run on the MP/M syStem. Although toe two system 
configurations are different, they do offer some basis for 


comparison. dqowever, in tne MP/M system, only operations 
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Table 3.3 
REMEX Transfer Times In Seconds 


ie | HARD BUBBLE FLOPPY 
, DISK DEVICE DISK 
FROM \ { 

"SINGLE COMPUTER EXECUTING PIP t™” 
ZARD DIS 2.5 a6 8.1 
3UBBLE DEVICE wn: 8.2 11.6 
FLOPPY DISK 2.3 o.6 12.2 

nO COMPUTERS EXECUTING PIP” 
HARD DISK 5.9 x 54 4 
BUBBLE DEVICE 11.3 x 54.6 
FLOPPY DISK 29.1 Xx X 

gee COMPUTERS EXECUTING PIP 
HARD DISX 19.6 x x 
BUBELE DEVICE 18.4 x x 
FLOPPY DISK 49.7 x x 


between the hard disk and floppy dis« were possible. The 
results of this test are shown in Taole 5.4. 

From these results, it can be seen that the multi-user 
CP/M-S6 system has a slight performance advantage for single 
user disk operations. Wnoen more than one user is operating 


in the system, this performance advantage becomes very 
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Table 5.4 
MP/M Transfer Times In Seconds 


j 
t 
Neon EARD FLOPPY 
DISK DISK 
J 
| 


ONE USER EXECUTING PIP UNDER MP/M 
BARD DISK (Ae: eo 


FEOPP PSD rak Petey 14.8 


eS eee Ge ee ee ee eee ee ee eee ee ee es eee ee ee eS eee cm SS ee 


tWO US@ZRS EXECUTING PIP UNDER MP/M 
HARD DISK 17.4 Zn e 
FEOO PY ebL SK 2020 x 


a ee es ee ee ee ee ee ee ee ees ee ee ee ee ee ee ee es ge ee ee ace ce 


THREE USERS EXECUTING PIP UNDER MP/M 
HARD DISK AO TA x 
FLOPPY DIS& 06.9 K 


Significant for transfers made detween areas on the hard 
mens Ks However, the REMEX floppy disk drives are slower. 
Since the REMEX hard disk can be used to emulate the 
“signal processor functions of the AZGIS system, a third 
test was conducted to determine the optimum sxew factor for 
consecutive read operations. A low-level routine was 
written to continuously read sectors from the hard disk into 
common memory. After each read operation, a counter was 
incremented. When five read operations had been completed, a 
Character was pricted to tne CRT screen. The time it took 


to print 80 characters to the CRT is recorded and 
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Laple 5.5 
REMEX Winchester Disk Skew Times 
in Seconds 


SKEW TOTAL SKEW TOTAL 
FACTOR TIME FACTOR TIME 
"4 10.8 2£@ 8) 3 
1 Mire ye) ra Sp Lore. 
2 0.52 7a 53. &d 
.) 1geo5 25 6.10 
: a 22) 24 S200 
) 11.45 Be 6.68 
6 eee 26 Sse 
4 ek 2) ae fe 
8 Vere? 28 Worcs 
9 14 OS) eo gral 
12 eee 2 ol”, «82 
ngs 13.05 O1 S02 
12 15.42 S2 E.5d 
135 13.45 ore esac 
14 13.70 54 Saeco 
ee, 4.2¢ ts) G.cd 
1,16) 4.95 36 9.45 
17 4.55 37 9263 
1é 4.25 38 Saeco 
19 ao 


approximates the time it took to conduct 486 separate read 
operations. During the first run, the skew factor was set 
home zero. Therefore, no sectors were skipped between read 
operations. In the subsequent runs, tne skew factor was 
incremented by one for each successive test. The results are 
Shown in Table 5.5 and indicate that a skew factor of 15 is 


optimal for reading data from the REMEX hard disk. 


C. RECOMMENDATIONS FOR FUTURE WORK 
There are several possible opportunities for future 


projects involving tne REMEX hard disk and the multi-user 
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CPYM-86 system. The first and foremost is the use of the 
system to emulate the AEGIS system. Several AEGIS system 
modules have already been developed and could be run  0on 
dedicated iSBC 86/12A computers using the REMEX hard disk to 
Supply simulated radar data. In the present hardware 
configuration, four syStem modules could be run Concurrently. 

Eowever, there are other smaller support projects which 
would increase tne capability and utility of the system. 
There is an urgent need for a more sophisticated text editor 
or word processor. Without one, the system will not be used 
Poe its full capabilities. Translating the 8889 assembly 
language code of BTED.COM into &356 assembly language would 
provide a more usable text editor than the one currently 
provided by Digital Research - ED.CMD. 

Another possible project is to develop a boot loader 
program for the REMEX Data Warehouse. AS the system is 
GSimerentiy designed, the CP/M operating system must de 
initially loaded from either the MBB-80 or from the MDS 
Single density system. This would allow CP/M to be booted 
from any of the memory storage devices currently in the 
system. 

A more ambitious project would be to design a boot 
loader which permitted the user to boot not only the master 
CP/M-86 operating system directly from the REMEX Data 
Warehouse, but the slave CP/M-S6 operating system as well. 


This would relieve the master system of the task of loading 
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the CP/M slave system and the boot loader program into 
common memory prior to booting the other slave computers. 
Furthermore, it would free a larger portion of common memory 
for general use and decrease the number of system variables 
that would have to be reconstructed should common memory be 
destroyed. The programs LDCPM.AS6, LDBOOT.A86 and BOOT.ASS6 
which are already written could be combined to form the 
nucleus for such a program. Once operating correctly, the 
program would have to be loaded into an iSBC &6/12A EPROM 
wnere it would be accessible to the monitor. 

feae final project could alter the CP/M-&6 B10S to 
include the Micropolis Winchester hard disk, tne MDS double 
density disk drive system, and the newly acquired 256K 
vubble Memories. The code for the Micropolis hard disk and 
the MDS double density cisk drive system has already been 
written and only needs to be put into the table-driven BIOS 
Pormat. The implementation of the new bduddle memories 


should be very Similar to that of the MBE-@¢. 
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APF ENDIX? A 
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PROGRAM DISCRIPTIONS 


I. MBB-&€6 BUBBLE MEMORY FILES 

A. MBSOFMT.CMD: This program is used to initially 
format the MBB-898 dubble storage device as a single density 
disk drive. When the program is executed it will prompt the 
user for a se#ment address. Tae address of €2W2 must be 
entered. The program wili tnen set the controller  odase 
address to 8@@@h and write the correct byte patterns on the 
buoble memory system to give it the appearance of a 
diskette. [Ref. 2: p. &&@ and p. 159] 

Bes M3EZROM.ASE: This file contains the source code 
meeessary for o00tstracping tne system from the bubble 
memory device. [t has been loaded into an EPROM and placed 
on the motherboard of the iSCB &6/12A computer labeled #1. 
It is executed by entering the command GFFD4:4 into the 
monitor of the computer. The program will then place the 
system loader into memory and transfer control to it. [Pef. 
fae p. 127] 

C. LDRMB&SO.CMD: This is tne loader program that must 
be placed on the bubble’s traces @ and 1. It will locate 
the file CPM.SYS on the dudble memory device, load it into 
Memory and then transfer control to the operating system. 
The BIOS for this program is created using MBBIOS.A8E with 


the loader conditional assembly switch set to true. 





De MBBIOS.AS6: This file contains the source code 
Mmeec to Create the EIGSs for both the CPM.SYS and the 
LDRMB88.CMD The CP/M.SYS BIOS is created with the ~ loader 
conditional assembly switch set to false. [Ref. 2 : p. 166] 

BE. DKPRM.DEF: Mois tile contains therm hardware 
configuration tables for arranging up to 16 MBB-8@ buodble 
memory devices or Intel MDS double censity disx drive 
systems in any combination. It was used by Hicklin and 
Neufeld in their implementation of a table driven 8310S. 
However, different I/0 devices (i.e. REMEX Data Warehouse) 
may not be added to their table. (Ref. 2: p.95] 

F. CONFIG.DEF: Contained in this file are tne disk 
definition statements used by dHicklin and Neufield to 
generate the Disk Definition Tables for their BICS. The 
file generated is labeled CONFIG.LI3B and is included into 
MBBIOS .AS6 when assembled. [{Ref. 2: p. 92] and (Ref. 6 


p. 67] 


Il. REMEX DATA WAREHOUSE FILES 

Bae. CPMBIOS.ASE: This file is the basic table driven 
Bros used in this thesis. By setting the MASTER/SLAYE 
conditional assembly switch to either true or false, two 
different CPM.SYS°s can be created. The only difference in 
Diem two is that the CPMMAST.CMD system contains code to 
initialize the synchronization and login variables located 
in common memory. The resulting MASTER fie should be 


renamed to CPM.SYS and placeca on the budbdle memory storage 
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device. Fntering the comand GFFD4:4 from the iSkC 66/124 
computer labeled #1 will boot tne system. 

When the MASTER/SLAVE conditional assembly switch is 
set to false, a slave system will be created. This system 
Shonld be named CPMSLAVE.CMD. Ptetsecnis file that =2s 
eventually loaded into common memory via the command 
pueem. CMD. 

After the slave system nas been ioaded into common 
memory, tne command LDBOOT.CMD must also ve executed in 
order to place the loader program into common memory. Once 
these two commands have been executed, all other computers 
can issue the command G£rggO:406 to the computer Monitor and 
toe CP/M operating system will be loaded for each. 

pie Cove eGrG: <Ints fife contains the label tables 
mom une seven 1/0 device-specific functions which are 
Smeeacted out of the BIOS. miese- func rions are “INIT, 
Seok, GOME, SELTRE, SELSEC, SETDMA, and SETDMAS. A 
conditional assembly switcan is located in the INIT table. 
When the master switch is set to true, two extra labels are 
inca ud ed which permit the initialization of the 
Syncoronization and login variables in common memory. 

c. MB8@DSK .AS6: Located in this file is the code 
feessary to read and write to the MBB-E&G Bubbl-Board. It is 
assembled into the CPMBIOS.A86 file »dy an include 


sStatememt. 


96 





dD. RXFLOP.AS6: [ice GONvaALNS =the code for 
reading and writing to the REMEX Data Warehouse's two floppy 
disk drives. It is assembled into the CPMBIOS.A86 file by 
the use of an include statement. Command packets for the 
REFMEX are built in common memory and all DMA is accomplished 
through common memory. 

The file laveled RXFLOP1.A86 is almost identical to 
RXFLOP.A&S6. The difference is that common nemory is not 
used for DMA or packet building. Instead tne REMEX directly 
accesses the host’s on board memory. Thus RXFLOP1.Ac6 will 
only work for a computer which has its local Memory address 
Space between 388300n and @FFIFFh. To permit additional 
computers to use this code, the packet addresses built in 
this BIOS will have to be changed to correspond to the 
computer’s memory address space within the system's 
addressable memory space of 1 Megaoyte. 

es RXHARD.AS6: This file contains the code necessary 
to access the Remex Data Warehouse’s Winchester hard disk. 
It also contains the blocxing and deblockxing code required 
for mapping the REMEX’s 512 byte sectors to CP/M’s 12& byte 
Mopaedat sectors. It is assembled into the CPMBIOS .AE6 file 
by an include statement. Command packets for the REMEX 
are oduilt in common memory and all DMA is accomplished 
through common memory. 

The 7ile RXHARD1.AG6 15 almost identical to RXEARD.A&E. 


The difference being that common memory is not used for DMA 





or pacxet building. see RXFLOP.ASE for more daetail, as 
Changing RXHARD1.A86 to accomodate more tnan one user 
requires the same changes as RXFLOP1.A56. 

ye CPMMAST.DEF: tnaS) tikeewconytains the CP/M=eGadisk 
erernition statments used in this thesis. [tis the @source 
file for GENDEF.CMD which produces the file CPMMAST.LIB. 

ar CPRM AS Deb 1B: Lpiseeerere | «62 Smassempled Minto 6a 
CPMBIOS.AS6 via an include statement. It contains the Disx 
Parameter Tables created by the CP/M utility program 
GENDEF.CMD, using the file CPMMAST.DEF as the input file. 

He INTELDSK .AE6: Mone =tniseerivess 5S not @acluded in 
the final hardware implementation of this thesis, LG 
contains the code necessary for accessing the [Intel MDS 
Single density disk drive system. Tt was used extensively 
in the early deveiopmental phases of this thesis because it 
provided an easy metnod of yooting a new CPM.SYS. tS 
fer iSsS)6included into the CPMBIOS, tne CP/M-s6 operating 
System can be vooted by issuing the command GFFD4:% to tne 
monitor. 

fle 3 LDCPM.A8E: This program must be executed in order 
tome toad CPMSLAVE.CMD into common memory peginning at 
EO 3509 . 

eile LDBOOT.AS86: This program must de run defore the 
Slave CP/M system can be loaded by the other computers. 
When executed, tne program SOOT.CMD will be placed in common 


memory beginning at E@GG:400. 





K. BOO. Cullis This is the loader program used by all 
Bowe, the initial computer to boot the CPMSLAVE operating 
system from common memory. It is executed by entering the 
command GE@60:480 from the monitor after the programs 
LDCPM.CMD and LDBOOT.CMD have been run. 

ihe RXFORMAT.AC6: When an I/0 device is first 
initialized for use under the CP/M operating system, tne 
nex code 2£5°5 must be written on the tracks which will 
contain the directory. otherwise the error NO DIRECTORY 
SPACE will occur. This program will write 55°s on the 
necessary tracks for each head of the Winchester hard disx. 
Since executing this program will erase all files accessible 
to the different heads, it will prompt the user for 
permission to procede in order to insure that tne files are 
not erased by mistake. Normally this program will not be of 
any use unless a new hard disk is installed or a directory 
track is inadvertently destroyed. 

Mie AXMAINT AGE: The REMEX Data Warehouse contains 
numerous oOuilt~-in error cneckKineg and maintenance programs 
which can be implemented by building and then sénding 
Maintenance packets to the REMEX. This program prompts the 
user to choose one of these dDuilt-in maintenance programs 
ecm then runs tie test. If an error is encountered, tne 
ermor- code is printed. The meanings of the error codes can 
be found in the REMEX tecnnical manual. [Ref. 9 : p. 3-19] 


tere LOGIN. AGS: This fiie contains the code necessary to 
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provide protection from more than one user logging on to the 
same area of the hard disx or tne MBB-8S¢ board at the same 
time. 

oe SYNC. Ac6: This file must be included in the BIOS 
when more than one computer is going to operate on the 
Multibus. It contains the code which prevents more than one 
computer from accessing shared resources while another is 


conducting a read or write operation through common memory. 
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PROGRAM LISTING OF CPMBIOS.A86 


;Prog Name : CPMBIOS.A&6 (Master/Slave CPM Bios) 


sModified ; Inclusion of Synchronization Routine 
;Date : 7 October 1982 

sWritten by : Tom V. Almquist and David S. Stevens 

;For > Thesis (AEGIS Modeling Group) 

sAdvisor >: Professor KXodres 

»Purpose eeaes Blos iS fOr use with toe 1SBEG/1<A. 
; > It requires a s@parate include fiie for 
; : each different I/0 device. 


oe HE OE BE NSA AE 3 BE BK BE OE OEE BOK OIC BK OR ED OE BOR OK BI A A a BR BE OE AR OO OS AK A 2 EK 2S BOK KOE AE 
} EQUATES 
oft DD 2 a A aR IE 2 REO ea A aK 2 DE AI OK EE BC A IE EE BE ORE EE KC BO 9 AE RE BK AE 2S DK AE OE OK A REDKEN OK 2S aK 


true equ -l 

false equ not true 

er equ dh ,;carriage return 

it equ dah ,;line feed 

error equ @ffh ;feneral error indication 
master equ true set for master/slave BIOS 


;system addresses 


pbdos_int equ 224 sreserved BDOS interrupt 
ccp offset equ 8dddh ;start of CCP code 

bdos_ offset eCqu OB@Eh »,2DOS entry point 

Bos offset equ 258vh start of 3I0S code 


;console via the 18251 USART 


cstat equ @dan »;status port 
cdata equ dd8h sdata port 
tboemsk equ 1 ;transmit buffer empty 
rdamsx Puu 2 ;rec@ive data availabdle 
cseg 
org ecpofrfset 
Sep : 
org bios offset 


a EYE OT AED NEKO BK EO OE NE OE NE OK IE SE OE BK SE DK OE ENE BE OK SK BK A SK EO OOK RE OK OE SE RE AK OK RE OK EK DIE 2K BK DK ME SISSIES OE OE a 


DEO S $ ;JUMP VECTORS 


9 EAE BE OE BE BE REA AE EAE EAE AE HE NE EA AC OE AE AE AE OK EE AE KE ECE SK AK ETE AE NE OE IE AE EAE AE 


3¢ 
3 
% 
4 
oS 
+ 
3t¢ 
at 
+ 
3t 
3 

3 
3 
3 
3 
+ 
3 


jmp INIT senter from BOOT ROM or LOADER 


eoRe 





jmp wEROOT sArrive here from E2DOS call @ 
jmp CONST sreturn conscle Keyboard status 
jmp CONIN ;return console keyboard char 
jmp CCNOUT swrite char to console device 
jmp LISTOUT >write character to list device 
jmp PUNCH swrite character to punch device 
jmp READER sreturn char from reader device 
jmp HOME ;move to trk @@ on sel drive 
jmp SELDSK ;select disk for next rd/write 
jmp SETTRK ;set track for next rd/write 
tme Seas 5G ;set sector for next rd/write 
jmp SETDMA ;set offset for user buff (DMA) 
jmp READ sread a 128 byte sector 
jmp WRITE sWrite a 126 byte sector 
Shem LS 3 Sab ;return list status 
jmp SECTRAN wae boOeieal—> vays. cals Sector 
jmp so2 lonss ;set seg oase for buff (DMA) 
jmp GETS s¢T sreturn offset of Mem Desc Tadle 
jmp GETIOBF sreturn I/0 map byte (iobdyte) 
jmp SETIOBF ;set I/O map byte (iobdyte) 

wi AK I BC RK AE HB OR HE a SKS SIE TA OR BK ORE AE aK OR TE CE ee HS aN EEE RE OE BE Be SCD A OK RE BK EE NE a aE EO Re 3K 

’ gmtry Point Routines 

oR BSCE HEC OK SR AAR AR a Hea aK HEARS AC PSiSH He Dis eH Ae RAS TRE Ke Mt eos ole ee oe Be oak Os RE oan oe Oe 


include login.as6 snecessary ror muiti-users 


— ee oe ee oe eS 6 eS ee ee ee eee 6 2 2 ee es ee ee ee ee a ee i ee ee ee ee es ee as ee a ee ee es eee ee ee 2S 


INIT ;print signon message and initielize hardware 

,and software 
mov ax,cs swe entered with a JMPF 
mov $S,ax 7$O use cs: as initial 
mov d4s,ax ;segment values 
mov eS,ax 
mov sp,offset stkbase ;use local stack 
mov iobyte,d ;Cclear iodyte 
push ds 
push es 
ead ;set interrupt 2 vector to 
mov ax,a ; address trap routine 
mov ds,ax 
mov eS,ax 
Mov int® offst,offset int trap 
mov intd_ segment,cs 
mov di,4 propagate to remaining vectors 
mov $1,¢d 
MOV “CX,o)0 

rep movs ax,ax 
mov bodio,bdos offset NGCOmmec Od OS 1 NL 2 veC tor 
pop es 


Jie 





pov ds 


Call Con vinit ;initialize console 
XOor UE, Dx ,fet mass storage 
taba ae et 

mMoviemaxant bl | ox] sinitlization table 

Or ax,ax squit if end of table 

ez ab Salah ce 

push bx 

call ax ,call init entry 

pop 0x 

LHe. OX »step to next entry 

Tac BOX 

Woubey — akeek ok al ,;Loop for next 

and 2 $ 

Call logia 

mov ox,offset signon sprint sign on mse 

Call pmseg 

mov Civ, user default to a: on coldstart 

imp, sClep Fj UMD LOucCOMdrenuryotaGUr 
AK ECOT: ;enter CCP at command level 

jmp ccp+s 
; ce cr es we cee wees ae we we we es we we es we a es ee we we we ew ww ew es we wes ee ees ee ee 
SONS. s »;return console status 


haat al,cstat 

and al,rdams« 

az Con 

or al ,@ffn sreturn non-zero if rda 


ONIN: s<€et a character from console 


Call COs 
ye CONIN »yWait for RDA 
in al,cdata 
and al,7fh »read data & remove parity bit 
te 
; I Se SS SS SS SS oo Oo SS SS ee 
CONCUT: ;send a Character to console 


in al,cstat 
and al,tvdemsk ,Zet console status 
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PZ CONOUT 
mov al,cl 


Out cdata,al *xmit buff is empty 
ret »then return data 
MCR te ge ee ee 
ms LOUT : »send character to list device 
»;not yet implemented 
ret 
—— amen ane CP ae ae = awe ee ew ee 6 SS Sw Se 8 oo ow 6 = Se SS oe SS © © w/w © oe ss © ee Oe w= oo = oe oe ee ee oe = oe 6 = oe 2 ee 2 2 = 
PonCs: wollte lerac ter to punch device 
;not implemented 
ret 
ee cee ee ce cee ee ee ew ce we ee ee me we ee ae er ee i ee oe = a ee ae oe et 
READER: ,fet character from reader device 
snot implemented 
mov al,ian ;return eof 
ret 
; te ete eee ce cee we ee cere ce cere ce cee wee ce ee te ew ee we a es i re ee ae = 
HOME: smove selected disk to trek ¢@ 
’ one of seven device specific functions 


mov trac«,2Z 
ror Oc -0% 


may DEsunit ;get offset to actual device 
add dx, dx 
call hmtodl {bx} scall device code via tables 
ret 
, 
’ 
i a ee a ee ee ene 
me bvoK : ,one of seven device specific functions 


sreturn pointer to appropriate ‘disk 
;parameter block’ (zero for dad unit no) 
wehbe NUNLUS: 1S Getined in tne’ .che file 


Move Un ibs CL ;save unit number 

mov bx,@@u¢h sready for error return 

emp (Gl, nunit s sreturn if bveyond max unit 
jnd sell 

MiGave ) . Duet b seet offset to actual device 
aad Ox mer 

cali dsktbl [bx] ;call device code via tables 


ROr- 0%. 0% 


1d4 





mov bi,unit pote ee Lie ovo 
mov cl,4 
Sn Dr, cl 
mov cx, offset dpbase ;bx += &dpbase 
add bx,cx 


—— —— a a ew eee SC ee a eee ee ee eee ee ee ee ee a a a ee ee = a= ep eee eee oe Se eee ee ewe coe Se oe oe ae eee Se eee see ae 


g 
Serine: ;set track address 
; One of seven device specific functions 


MOv. tracker cl 
xOr bx, vz 


NOve O83 Gn t szet offset to device 
add 6 6bx, ox ; 
Gat) Uber bl Lox | scall device code via tables 
ret 
} oe ee ee ww we we ee ew ew we ww we es ee we ww nw ww we we es es we ee we we ee ee a ae ee 
Se ShC : ;set sector number 
} one of seven device specific functions 
mov sector,CL ; 
ROr . 0x5 
mov Ol sunit ;get offset to device 
add bx, bx 
call sectbdl [dx] ;call device code via tables 
ret 
—— — om oma ee me wee we os we Ow a we we we ew www Ow Ow we wm Oe ew me oe me ee oe ewe eee we we 
me DMA: ;set UMA offset given by cx 
mov dma_adr,cx 
rey 
; ee ee a oe en eee ans ae dee a ee on en en Gas ae OD os aD oan ann ans a Gee oes OD Gee Ga ann Onn ene Ga as ons tae OE gas an oes OE OD os oe SO ats os ON on a om ee 
Rane 3 sread selected unit, track, sector to dma addr 


sread and write operate oy an indirect call 

; through the appropriate taosle contained in 
,tne configuration file. It is the programmers 
sresponsihbility to ensure that tne entry points 
,;in these tables match the unit type 


mov » De. ox 
Mov LOL sun. t 


add bx, bdx 
eat ratp) ( px] scall device code via tables 
ret 





—- > ame ame 2 ep = eee SE ee ee ee ee es ee ee ee ee ee ee ee ee ee Ee Se ee ee ee ee ee ee ee eee Se ee oe ee ee Se eee = oe ee ee eee Oe Oe 


WRITE: j;write from dma address to selected 
sunit, traek, sé€ctor 


Zor bz, bx ° 

mov bl,unit 

add bx, bx 

call wrtbdlLbx] ;scall device code via tables 

ret 
; ee ce ee ce se ce re a ce cee ae ce ee cr ee ae ee ee ee es me es ee we we ee we ae a ee ee ee 
ls OT : MoOlt Last agevice Status 

>not implemented 

or al ,@ffh sreturn ready anyway or 

ret ssystem may hang up 
; ee 
SoC TRAN: sumanSlate sector ex vy table at idx] 


sNOTE: this routine is not adequate for 
;the case of D= 256 sectors per track 
>still it’s better than DR°s which is not 
sadequate ror the no table case either 


mov co,2 
tO Ver Goce x 


C0 “dag schece« for no table case 
je sel 
add bx,dx sadd sector to table addr 
miery 51, box] ;€et logical sector 
Sel? 
ret 
——<<£“o.| OS ee a ea a a aaa aa ore ra 
SETDMAB: ;set DMA segment given by cx 
mov dma sez,cx 
ret 
; ee ae ee ee ee we wn en es = ee rr ee we ee ee we ee ee ee 
GETSEGT: ;return addr of pnysical memory table 
mov bx,offset segtadle 
ret 
7 (eo ee 
eT LOSr: sreturn iobyte value 


io ce = vals func on and Set (COEF 
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al,iobyte 


pane ok OU tO implement the function 
;the character [JO entry point routines 
smust be modified to redirect [0 
;depending on the value of iobdyte 


a «ane a ae Ge ae ae == oop ee 685 ew ape 2 a ee em cm eo c= ase SS ase © ape GP GP ee em om SF Ge Ge eee se aw cm cm a= GU ame GPS Ger ew ame =) GP GF 2 aww ase © Ge Ge cue ae 2 a= 


} 
SETIOBF: 


@®2@e we Se 


Mov 
ret 


eon 10it : 


ret 


;set iobyte value 


LO Oyace .c 1 


BAK AS OE AS HK HE AK IE A AE AK YE AS AC NE A EEE AE AS AE BIS BEE OIE SE IE FS OS OE AE AE SIS ERE OE OE NS HE OS OK I IE OS NE SS OIE ROIS IE OE IE OIC OK 


SUBROUTINES 


BEAK HE BS HEE HEE BE OE OK BE BE OE THE IS NE AS IE IE OE EE IE AE OIE HR IR BIS OE OS AE OS IE OE EOE OK OIE OIE OIE OE OE YS NE OK OK AE SIS NE EC NE HE OE OS 2S 


pmoeue rrp: trap = non interrupt 
;driven system so should never zet 
snere - send mesagse and alt 


OU LOGCH I LerrUDts 


ax acs 

ds,ax ,get our data segment 
DeOmeese lt Lntwtrp 

pMSéE 


shardstop 


sinitialize console driver 
s;actually done by the iS2C&6/1l2a monitor 


;send a message tO tne console 


Sues Ln) szet next char from message 
al,al 

pmsl pir ero fe curd 

Ci gral: 

CONOUT pein, Wt 

OX 

pmse snext character and loop 
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DMS. < 
rer 


ae 3K Xe 3K SE SCE BK he He 3H A ae Ae ok as Oe fe Xe BIE ae ice BC a 2K oH ofc BE Oe oe ag ake oe fe ae ok Bi oh ae 2g Se ae ae ake oft ole aft ale o/s akc oft akc a of ak 


; 
’ DISK SPECIFIC FUNCTION LAB&ZL TABLES ; 
9 DE RE BH OK DEER OK BK DE BI AE BK SEE SK BORE OE BK SKS BK BC BIE BK AE OS CO NE 9 2 OK OK OIE 2K BA aE 9 9 BE aE as SE a 2 Re ME a OK Bea 


sThe included .cfg file below maps unit number to disk 
sdevice type. I[t provides tables or entry point 
saddresses for use dy init, seldsk, seltrk selsec, nome, 
sread and write. Tnese addresses must appear in the 
Meperopriate include file for the particular device tyre 


include cpmmast.cfg j;read in label tables 


Sesto sini crea mx Ne aoe es om os RR Oe OR oH OR OS oe NE Soe ke AE OR IK OO 


$ AR AE RK Be DRC OE aK RE 2 SH SHEE EE OKC DE Be a aE NEE De 
} DISK I! 

9 MEME TEAK AE AE AE AE AE HE NS EE OEE OK EE OE OE EK OE Be NS BE AS ALS ASE AL AS SC CL AE SI AS SK OS NS HE TK OK AK ENE OIE BIE IE BE OS HS BIE BE EE 
;For @ach I/O device to be accessed dy the operating 

system a separate file must be included. Within each file 
,seven functions must de addressed and are the same ones 
;mentioned in CPMMAST.CFG. Tne labels used to access tnese 
meeae tions must se properly order in CPMMAST.CES. 


include mbE@dsk.a&Eé »MBEB-EL bubble memory 
include rxfiop.a&6 fj ei keer oy a LSsKs 
include rxhard.a&g6 ja etre ee are G@1S5% 

p MEAS AE HE EAE EAS AE AE AEE OE OE IEE EE AK ANE EE Fa CE DE FE DI AE OE AE TIE AS RE DIE FAC HE AE AEE EOE ES THE TIE IS NE BK TE FE 2S IIE ETE MEE AE AS 

; Reo OURGE ALLOCATION 

gS HE BE RE 2 OK IS BBE OK a OKC A ae OAK BK a OE BE NE OEE HE BIE aE AE SIE BOGE ER a SIE As ME ANE BE BK BE BE DIC OK OK OIE BIC BK BE SKE BEDE BIE EDK 2 OK 


;LOw-level synchronization of access to the sharead 
;aevice. <sync.a86> must include the entry 
points defined in the cfge.files. These are 
Peatled On initialization and before and after 
syaccessing the resource respectively. 


include sync .a&6 


3 
2 
x 
ae 
2 
rd 
% 
% 
4 
x 
ot 
3t 
ue 
iy 
% 
ae 
“ 
% 
a. 
? 
An 
78 
+ 
v1 
ae 
4 
24 
my 
At 
rity 
i 
% 
£ 
% 


HE NE 9K BEE SSK HEHE OS BK HE AEE a OE OC aE eC fea a HE OE IE eg HEE 


; 
; DATA & LOCAL STACK AR 
; ze 


a 


MEAT AL IK ALIS EAS AE AE HE AS AE HE ASAE HE HE 2K OK EHS EE AS AS AE AS TE BE OIE AS 2 


cseg $ 
signon db Giese SCT slat 
db Comue.lf.” : 


if master 


iu (S 





db “CPM/S6 Master 


endif 
if not master 
db “CPM/&6 Slave’ 
endif 
db ermit ,lis _Modified ° 
db “ 6 October 1982 by’ 
db * Ae VE. 5 Veta” Tom ¥. Admauist~ 
db “matcd David S. Stevens ,cr,l1f,lf 
db ° For use with a Pubble Memory and ” 
db “the REMEX Dataware House’ 
db Cheat. Oo 
mae trp db Cr gat 
dd Climterrucs Trac dalt 
ad Ona we ieee 9, 
Mopyte rbd i ,eONnamac ver 170 Tec recticn byte 
el iae rd it sselected snnit 
track rb 1 »selected track 
Bector rb 1 ,selected sector 
dma_adr rw i s;selected DMA address 
dma seg rw 1 sselected DMA segment 
moe stk rw 32 muceal Stace tor 2nltiali zation 
stkdase eu offset $ 


;system memory seement table 


segtable MeO 4 ,1 Segment 
dw tpa_ see ;slst seg starts after 38105 
dw tpa len pane EXtenas LO LOp Of 77-8 
dw 20095 
dw <€@¢eH 


Bee Saat tye 34k 24s 2 EH BIE SKIKE OE 28 BIC IE BYE NE SHE OK AE BFC aK NGC BE AE fe NEE HE IE NS BE ONE 3 aE NE Ofc NS NE eH aye OKC a De ate 3fs Be ONE OY ake aie a Ne He Ne BEE He ak 
DISK DEFINITION TABLES 

BE AE SK HE AE AE AE IE EE BS OK OR BS OIE DS SS AS AE AK SK OK OE OK OK BS TS BSS BS OE YS DS AS DK HS AE BIC NS DS BS AK OS OK OK AS AE OK OK SR SS TI AE IS KR AS OK 

meamemocjuded .lib file contains disk definition 

stables detailing disk charécteristics for tne bdos 

»>-lib files are generated by GHNDEF from definition 

sfiles and must comply with the allocations made in 

memeecorresponding confieiuration file. (Lable Taodles) 


include cpmmast.1lid sread in disx def tabies 
oS SK SE RE EH AK BK a ICDS RCD DEA aK SE AE OE REE TE BE a EE OE SE 2g aK ON BK AK OK BE OK EE Be 9K EE DI Be BIC IE Ne aE ae 2 
; END OF B1OS 
; WEAK BK AE BS OE AK BK BS OK OK OK OE HE TE AS AE OE AE FS AS OIE OS Ok BIS BS BS AS AS BK OK AS AS OIG OS TIS OPS OK AS AS AEE OK OK OIE OS OE TSE OK ROK AE OK OS 3S 
lastoff equ offset $ 
tpa seg eq (lastofi+0490n715) / 16 
Meas Len equ Pogo = lpas See 
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HE BE RE AE HEE HAE BE AE HE BK OK SE AK AE OE AE SE IE AS KE OE SEE OE AE AE ASE AS IE OK REE SIE EE OK 2S NE BE IR OEE OK OIE NE XE OK aie COS oe oi aK oie ote ok oe 


PAGE ZERO TEMPLATE 
EK AE AR BE RE AK RE 26 RENE AE 2 2 AE AK AE AK 9 BCH OC A RE AK OEE AE AS SE A OE A SICH ONE RE ee Oe ae a Ne OE a aE aK a aE OE Ea RE AK ag aK 


w?e @2@e we 


dseg M ;yabsolute low memory 
ore 4) >(interrupt vectors, 
mato offst rw i 
int@ segment rw i 
rw 2*(bdos_int—-i) 
bdio rw ul »,ddos interrupt offset 
bdis rw 1 »;dodos interrupt segment 


ee, 





APPENDIX C 


— — oe eee ee oe —- 


PROGRAM LISTING OF CPMMAST.CFG 


;Prog Name : CPMMAST.CFG ( Master Configuration for CPM) 


;Date >; 13 September 1982 

pWritten by : Tom V. Almquist and David S. Stevens 

;For : Thesis (AEGIS Modeling Group) 

;Advisor >: Professor Kodres 

»Purpose = Wes code 25 an include file w/in CPMBIOS .ASsé. 


Ht contains the device tables for access to 
Mer tidiizeation, read, Gewrite routines. 


“soe Ss 


—__ a En a a a ee ee a qe ee eee Ge eee SE See ee ee ee ee ee ee ee ee ee Ge oe ae —= CE Ga Se aa = ae a eee GE ewww SE aw SS EE ae ee 


} DEFINE nunits 


Gaaits dab 7? ;total number of mass storage units 


—_— oe oe ee 6 See Se Se ee ee ee ee ee a ee ee ae ee ee eee ee ee ees eee ee ee ee ee ee ee ee ee ee eee ee ee ee ees ee eee ee ee ei ee ee ee ee oe 


INITIALIZATION TABLE 


~we¢ we 


sintbl contains a sequence of addresses of initialization 
meetry points to be called by the BIGS on entry after 
sa COld boot. The sequence is terminated by a zero entry 


teat D1 dw offset mb8ddsx init ;initialize Bubble 
dwmofiset rxflop init ;initialize remex 
ip mas ter 
Ow 0ftSet ingtsync sinitialize syne variables 
Wesel elouG Lorin PAO reba i 2c oes 
Smit f ; procecures 
dw J »end of table 
’ Ae eS me Sam ee enw Same mms NTS amp SS GE ED SS Sem Sam em ee me Se ee mre ene cle mm cme tne em eee eee ee eee ee ee ee ee ee ee 
; READ TABLE 


srdtbl ard wrtbl are sequences of length nunits, containing 
»the addresses of the read and write Entry point routines 
srespectively which apply to tne unit number corresponding 
»to the position in the sequence. These and the entry pts 
meorve initialization must correspond to those contained in 
»the appropriate include files containing code specific 

;toO the devices. 


Bat bd dw offset mb8ddsx read ;A: 15 a bUbbie mMemorz 


aWeorwse (UE er Foc read 38: 15 Remex floppy disk 
dw offset rxflop read 9Cs is Remex floppy disk 


et) 





— ie ee ae ee ee ee ee a wee ee ee SD a ee a eS ae oe ee i ee OS ee ae ee Oe as ee ee ee ee Se See ee re eee a ee ee ee 


asktbdl 


Mere t DL 


offset 
offset 
offset 
offset 


Pena d read 
rxhard_ read 
rxhard read 
rxhard read 


WRITE TABLE 


offset 
offset 
offset 
offset 
offset 


, OFT set 


Oft set 


O27 Set 
OLfise tl 
offset 


offset 
offset 
offset 
offset 
Orfset 
offset 
offset 


offset 
offset 
offset 
offset 
offset 
FL LSet 
offset 


mb82ds« write 
IeeloOr write 
rxflop write 
rxhard write 
igo, lol sUatol = Coe sgt = 
rxnard writ 

rxnerd write 


BOME TABLE 


mb8@dsk home 
Fxflop nome 
rxflop home 
rxhard home 
rxnard home 
rkharc home 
rxoerd home 


mo8ddsk_selds 
rxfilop selds« 
rxfiop seldsk 
rxharid seldsk 
rxnard selds< 
rxhard_seldsk 
rxnard seldsk 


»D: is Remex 
94: 1s Remex 
ss: is Remex 
»G is Remex 


x 


SETTRK TABLE 


mo€vdsx« settrk 


rxflop settre 
rxrlop_settrk 
Daehe Se titink 
rxhard settrx 
rxndard settr« 
Eeoere Seri r se 


hard dis 
nard dis 
nmard disk 
hard dis« 


o_— en om ae ee Oe aoe Ce cw oF = aoe ae es aes a ee ei ee ees ee ee es ee en ee ee ee ee ce ee ei eee ee eee eee eee ee 


Nut’? & 


—— =P ee eee 2 gap ee See oe C2 ow Cee S® ow Se om om O® oo SE o- oe CS Se ow Gee = ow Oo @ ae © "* 28 as Oo SE aes OS Oe oe ee ee Oe en es Oe ee ae OO oe Oe Oe Oe Se ow oe ow 


EE ae ee Se ee ee as ee ee ee es ee Se ee ae a ae GS See es a a ee eae Sa a eS ee Se a ee Se ie es ae ee Be ee 





— o> qa cee Gee Gee eee es ee ee ee ee ee ee ee ee ee ee ees ee ee eee ee ee ee ee ee ee ee ee ee ee Se cee oe ae ee ce See ce eee ee ee ees ee ee ee ee ee ee ee ee ee ee ee 


; SETSEC TABLE 


sectbl dw offset mb&@dsk_ setsec 
dw offset rxflop setsec 
dw offset ratlop setsec 
dw offset rxhard setsec 
dw offset rxnard_ setsac 
dw offset rxhard setsec 
dw offset rxhard_setsec 


Ee 





PROGRAM L MREOTSK.AS6 


yProg Name > MBG@DSKAS6 (BUBBLE MEMORY DISK) 


;Date ; 24 Auge 19&2 

ymoagified by : Tom V. Almquist and David S. Stevens 

sFor : Thesis (AEGIS Modeling Group) 

sAdvisor ; Proressor Kodres 

;Purpose imniomeco@e 1S an include fille w/in CPMBIOS.AGG 
} It contains the code necessary to access the 
j bubble memory as 4 dis« drive. 


PEt tte ttttttteere—ttett+ HQUATES +t tet etre teteter re rt rtttt+~ 


Ce SaaS SSS Miscellaneous equates --------------H-= 
mb contbase equ 83904 »controller vase 

addr _ high ram equ @f@dgk snien para user avail RAM 
dDdos_int_type equ 224 sreserved BDOS interrupt 
Beector size equ 128 ;Ceweelogical@ase secior size 
joo Magnetic bubdble characteristics (MBB-83) --~------ 
Momour | en equ 144 jouer (ene Unt Or ee sec. or 

mb maxdevs equ 7 souddle devices are #9-#7 

mb maxpages equ 641 9¢ Of pages on each device 

mb maxsectors equ §¥9 7#.0f Oe. SeECULOrS On eCach dev 

mo pages sec equ 6 »# Of pages per logical sector 

mb pagesize equ 18 sdbubddle device page size 

mb skew equ led »>sxew factor for page xlation 
;-~--- Magnetic bubble command bytes and nasxs (MBB-&@) ---- 


MOecheDUSy cmd equ 0929 315 controller »susy ? status 
mb chxint mask equ g80H ;mask to chk for MPE inteérupt 
mo imhint cmd equ 80H ;interrupt inhibitysvreset mask 


Goeinit cmd eau €1£ siniviakize the controller 

mb mpage cmd equ J19H j;multi-page mode operation cme 
mb read cmd equ Jg1l2H ;multi-page read command 
molreset omd emu @40u ;reset the controller 

mb write cmd eugu @14H ;multi-page write commend 

’ 

CSEG $ 





SHER HEHEEP HHP HEHEHE FEET HEE PHT HH HEH HH PH HEP HHH HHH He tt eter tee 


; DEVICE SPECIFIC ACCESS CODE 


PtH PEPE HEE HEHEHE HERE HH Ket e tht Erte Hee He HH Ht tote pittters 


yinitialize bubble scalled from INIT 
;parm in - none 


sparm out —- none 


mb8@dsk init: 


push e's 

init _mbdbd&e: 
mov ax,mb_contdase ;controller base 
MOV @5,aX pacdress to es ree 
Mov aXx,mb_maxpagzes spes per douoddble dey 


mov es:mbp_loopsize 13,a4l 
Mov 2S er 1oousize hi,Ar 
mov es:mbp_ pesize reg,mbd_ pagesize 


,issue reset command to the controller 2 
mov al,mb_reset_cmd sreset mask byte 
Mov es:mbp_cmnd_reg,al »issue reset cid 


sinitialize each bubdle device 


Push 1c x HSOVeTOm, OUSeET Conte 
mov cx,mbd_maxdevsril fCOUNT fOr 1O00E—s Of saevs 
mov al,d ; sagevice # to initialize 


Boar each: 
mov es:mdp select 5ub,al ;select eacn device 


may “€S-<mop cmnd ree ,mb init cme pI oe vi ce 
push ax!push cxripusn es ;Save bud#,counter,es 
call mbdv&€ wait sWait for controller 
pop es! pop cx! pop ax preset es,cnter,MSERF 
jac al snext device number 
RGOp Por each SoSIomnC X ,* LOO: 2Ot:-7eER0 
moe 7 Cx preset. CX, OlCer cnter 
Pop es srestore register 
Device ret: 
ret 
; SoD, SED GED GOED SUED Te cman came cemaD GD De GD OD cee CD eee > a ee Ge ee ee es ee oe em ee ee ee em ee 
sHOME BUBBLE ;calléd via nome table 
mop@ddsk aome: 
Om: Cx uCx 7Sset track to zero 
Cali Sevres 
ret 





— oe eee ee cee eee eee SS a ce ae oe ae ee oe oe coe SS oo oe oe ee 6 oe ee ee Se Se eee ee ee ee ee i ee ee ee ee ee ee ee ee ee ee ee ee ee eee ee eee ee eee ee eee eee ee 


;SELECT BUBBLE DISK yeCaliledeviawselads* tape 


moSddsk seldsx: 3no special action required 
ret 
; et ee es es wees ee we we we ws we wes ew we ee ee we ee we ee ee we we we we wn ee ee ee ee ee ee wee ee ew es we ae ee ee ee ee 
SELECT BUBBLE TRACK »called via seltrx tadle 


mb@@dsk settrk: 
Call mbd89 tracx« xlat 


iia ep 
; cerns ma ces eam serv ema cts am ces es cs ts comes em ces ms eet ces ee ee ee me es cs wee ee ms ee ms ee re es wee es ws ee we es es we we we ee we we we ee 
;OET BUBLE SECTOR ;called via setsec taole 
mb&€@dsk_setsec: pLOMSPeCl at acurOnm eequired 
ret 
; ear ccs es om cs es cs cs es we ee es wee ms re we ce we we ws we ce we ee we ee es we we es wm se es = ee 
»>MBBEQ READ Called via read tabdle 


;reads a sector from bubble 

;parm in - none 

;DaRMnOuL se Statusmor tne opein ali. 
;5 @¢€= OK, FF= unsuccessful 


moS@gdsk read: 


call request s@et resource (SYNC .A86)} 
push es ;save register 

call mdb8@_sector_xlat compute ist page# of sect 
Mov ax,mb_cont dase yaddr of controller base 
mov es,ax ,;load es to address budole 
Mov es:mbp_cmnd rege,md_mpage_cmd ;multipeagze cmd 

mov ax,mb_page no s;current page numoer 


mov es:mop_pagesel_ lo,al ;page select lo byte 
mov es:mop pagesel hi,AH ;page seléct hi bdyte 


,set numoer of pages to transfer = pages/sector 


mov essmbp pagecnt 10,mod_pages sec ;,#pages xfer 
mov es:mop pagecnt_hi,g ;hi oyte of # is 2 


,;5et up dma address to receive data 


mov cx,mb_bdbuflen poomc fOr 1oOp—buffer size 
push ds ;save CP/M’s ds 

Mov ax,dma_seg ;get dma segment 

push ax Save ama segment ds 


LOS 





mov »vx,dma_adr soffset of dma area 


;select bubble device and issue read command 


mov al,mb_bub_no ;current bubble number 

pop ds ;Local, readdr dma area 

mov @simbp select bub,al ;select current dev # 

mov es:mbp_cmnd_reg,mbd_read_cmd ;read from FIFO 
head int: 

mov al,es:mbp_ int flag ;get interrupt status 

and al,mbd_cnkint mas« sinterrupt set ? 

jz Read int ; if ero weeco checking 


;read enough from budblie sector to fill dma area? 


cmp cx,(m>o_buflen - sector size) j;xfer enough? 

jnz Read_one Oy Sead anoune nr pyle 
pop ds ;restore CP/M’s ds 

mov ox,offset mb overflow ;reset dest to ovrflow 


;read from MBB FIrFoO buffer into dma area 


Read one: 


mov al,es:mbp_rdata reg ;read a byte into acciam 
mov | boxed | sload accum into dma area 
mc 86 ,sincrement index 

loop Read int (CCC OMe) Vr Ot cen 0 
push es save es for call 

Gali Ma0ee Nait Wiel Vitec GO At Oey 

pop es srestore es after call 
mov eS:smMdp cmud rege,mb_inbint cmd ;clear int 

mov al,d pineal Cave no error 

push ax ;save status of read 

call release ;freeé resource (SYNC .ASé} 
pop ax srestore registers 

pop es 

rev 


»MEBE@ WHITE Called via write table 
swrites a sector to dudole 
;Darm in — none 
;PatMeOUl = SUaeds Of «tne woD: in sad 
5020 = OK, FF = unsuccessful 


mbGgdsk write: 


mov al,d »bubble logical drive 
cmp al,user ;is user logged in on md&@ 
o2 Mpwrt err 


Cae SeQuest (SYNC .AG6) 


push es 


,eet resource 
,;save register 


Hele ig 





Galleimpe? Sectorsklat ;get ist page# of séctor 


mov ax,mo_contbdase yaddress of controller base 
mov e@S$,ax sloadi es to address bubble 
mov es:mbp_cmrd_reg,mb_mpage_cmd;multpe mode cmd 
mov ax,mbd_page_Nno »;current page number 
mov es:mbvp pagesel lo,al »;page select lo byte 
mov es:mbp pagesel hi,AH ;page select hi byte 


;set number of pages to transfer = pages/sector 


mov es:mbp_pagecnt_1lo,mbd_pages_sec ;#pages to xfer 
mov es:mbp pagecnt hi,gd sO. soy te of # 1S azer7o 


»>set up dma address for transfer 


Mov .cx,m our lea=1 pcOuUnt for loop-write 
push ds ;save CP/M’s das 

mov ax,dma seg »eet dma segment 

push ax .3 save dma segment ds 

mov bx,dma_adr saddress of dma area 


>select budble device and issue write cmd 


mov al,mb_bub_no »current bubble number 
mov es:mbp_ select _dub,ail ;select current dev # 
pop das sreaddr dma area 

mov al,{[bx] sload first dsyte 

mov es:mbdp wdata_ reg,al swrite oyte to MBB buff 
mac 86k sincrement index 


mov essmbp_cmnd_rezg,mb_write_cmd;send write to MBBS 


swait for interrupt from controller 


Weite int: 


mov al,es:mop_int_flag sget interrupt status 
and al,mb_chkint mask ;iNnberrupt set 7? 
aie Wie eons sif zero, keep checxing 


swrite into MEB FIFO buffer from dma area 


mov al,{bdx] sbyte from dma to a} 

MOY  eS:3mopewdata reég,al ;write byte to MEB buff 
me Dx sincrement index 

HOOpMW Alte Lnt (ecw em, 1 G0) 1. NOt. Zero 
pop ds srestore CP/M’s ds 

push es ssave es for call 

call Mbbd82 Wait sWalt for controller 

pop es srestore es after call 

mov essmop cmnd_reg,mo_inhint _cmd;cleer contint 
mov al,@ PeewlGcon success code 

push ax Fave msucCcCeSs  COCe 

call release sfree resource (SYNC .A&6 ) 


1k ie 





‘ee : : > 


pop ax 

pop es ;restore register 

jmp mobodwrt_ret 
mowrt err: 

mov vbx,offset mbdwrt_mse 

call pmse 

mov al,#ffh serror returned to CP/M 
mowrt_ret: 

ret 


PPR ARR EHEE HEHEHE EH EEE EERE EE HH EEE ELEE HPht EEE HHH EHH Heese tet ree 


; BUBBLE SUBROUTINES 


PEEPS HEHEHE HEHEHE HEHEHE HEHEHE eH eH ere TrH tHe thw treet Ht et rt ree test 


] 

»>MB38@ SECTOR XLAT called from: Mbb8@ Read, MbbDE® Write. 
;computes 1st pager for a fsiven sector 
;On a Single chip. Based on &3 sectors 
nOMeeach Chim sector = 126 pDytes. 
;parm in - none, worxs on sector 
;parm out - none, updates mb page no 


homes Sector Alat: 


xor az,ax 7set ax to gd to hold page# 
EOL ¢x,cx joweerucr for Counte: 
mov CL, sector ;Ctret o Cetra nslation Loop 
zor Pier ,;clear Dk 
mov DL,m>d_ sector ;sect# for 15% sect on trk 
aad Ce, x sadd ist sects to los secté# 
dec CL PSC hac. al Tor tne 1o0n 
4 Mbb8d sx exit poeCT l- US i pase oO, Do Yr lat 
Add skew: 
add ax,mb_skew ,add skew between pages 
Clic »;clear carry 
s$)dD axX,mbd_ maxpages »smod to # of pages 
jae Dec _sector ;jump if positive (CF=9) 
add ax,mb_maxpages ;went (-), add dack #pazes 
mec sector: 
loop Add _ skew sdec sector#,add skew avzain 
mopewe SX exit: 
mov mb_page_ no,ax »Store paze number 
ret 
’ 
’ 
ee es ee Se 
»>MBBEO TRACK XLAT Cia Ped tr On 2 eo ERK. 


;computes budbie # Prom track #. Gets 
sfirst bubble sector (1-8@) for that 
;track for later conversion to page #. 
Pearm 12 = Odne, words On trace. 

ple Out a 2Oaes MO DUD NOV) Sector 


lig 





mooed Track Xlat: 


Yor DE, ox [Clear epe for add 
mov  Ebetrack jloOad track = index 
qad ShesE ;cOuUs Me tracks for imdex 
mov ax,mbd_track table[bx] ;get word from table 
mov mb_bub_no,Ad ;low byte = budb device# 
Mov mbd_sector,al »sOigh byte = 1st sectoré# 
ret 
Sa San 5 = ee AR pee . a e 
»MBBEO WAIT called from: Mbb&@ Init, Mbdd8@ Read, 


sMbbd80 Write. 
PCOCCKS Statice. oo econt Lon nous) 
skeeps checking (wait) until not dusy 
;parm in - none 


;parm out - none 
Mbo8@ Wait: 
mov ax,mb_cont base saddress of cont base 
mov e@S,ax »;load es to addr bubdbdble 


See zero: 
mov al,es:mbp status ree ;get status rezister 
and al,mbd_chxbusy cmd pis tb ai Zeros -¢ 
3] 4 see zero jf so, ceed checking 
Cont_busy: 
mov al,es:mbdp_ status _ rege ;get status register 


and al,mb_chabusy_cmd $S€€ if dusy, anc tO mas« 
jnz Cont_busy sif ousy, check again 
ret 
PPE HEHEHE HEHE LEHEHEE HEHE H+ — HH HHH Se PE HH HEHEHE HHH Ht tHe ete rte HHetHeter 
’ DATA SEGMENT AREA 


PEPPER HEHEHE EEE EEE HEHEHE MH RHE HH He HT HHH mt Hr HHH et pert rt terse 


—— —-- Pea a WCG emesis eS ee 
rowrt mse db cr,lf, Write Access Not Permited’ 
Gis On Thismorave. 9 


mb bub no 1 |e) ae »bubble device number 4-7 
mb_overflow rb (Mb_ouflen - sector size) ;read overflw 
mb page_no rw soil ;dudbbdle page number 

mb sector Woe 2 sbudble sector number (1-80) 


sSach entry in the track tebdle corresponds to one of the 
324 tracks on the MBB-8¢@. The 1st byte in each entry is tne 
sbudble number; the 2nd byte in each entry is the starting 
ssector number for that track on that bubble device. 

mb track tadle dw 9@00H,201aH,00340, 9140H ,d31lan,31344 


12g 


} 
eskG 


] 

top pagesel lo 
mbp pagesel hi 
mop _cmnd ree 
mop rdata_reg 
mbp_wdata reg 
mop status_reg 
mbp pagecnt_lo 
mop pagecnt hi 
mop loopsize lo 
mbp loopsize_ hi 


mbp pesize reg 
mbp_select_bub 


mop_int_flag 


dw 
dw 
dw 


rbd 
rb 
rb 
Ole, 
ro 
rd 
rbd 
ro 
rb 
rb 
rw 
ro 
rw 
rbd 


equ 


O200H ,021aH,02344,835008 ,OSlak ,0554H 
O040CH,041aH,0454H, O50GE, G51lak ,JSS4E 
O600H ,J61aH ,9654H,9700H ,271aH ,O7544 


ro be pe be be pe tp pp 


31s byte for page select, (0) 
sms 2 bits for page select, (1) 
scommand register, (2) 

sread data register, (3) 
swrite data register, (4} 
;Status register, (5) 

sls byte for page counter, (6) 
sms 2 bits for page counter, ( 
(Seve tor minor 1copEs ize 
;MSme. DUST Or Mig. 4600 Sige 
sinternal use(page pos,, (A, 
;page size register, (C’ 
poise cule (Da) 

stwo uses: select dsubble dev (fF) 


‘ 


mop select_bub ;interrupt flag (?F) 


aka 





;Prog Name 


] 
>Date 


pWmeuven by : 


,For 
;Advisor 
»>Purpose : 


*@e We @E @O we 


e 
’ 


@e¢ we we we 


APPENDIX & 


PROGRAM LISTING OF RXFLO?.A86 


RXFLOP.AS6 (nEMEX FLOPPY DISK 

ACCESS CODE) 
9 October 1982 
Tom V. Almquist and David S. Stevens 
Thesis (AEGIS Modeling Group) 
Professor Kodres 
This code is an include file w/in CPMBIOS.AS86. 
It contains tne code necessary to access the 
Remex floppy disk drives. I/0 done through 
common memory. Tnois configuration is set for 
Ge Mebhorica: drives 1 °(B:) and 2 (€:). To 
alter, change code in RSAD and WRITS routines. 


FHEEHHHHE PTET HHHEHEHHE+ EQuatl es Fete te ttt rete tt tet treet —tttit 


meee Disk Cont 


dk rdy_mask 
dk rd_cmdi 
Gxerda cmd2 
dckawr cmdi 
dk wr_cmdz 
Gries 
drivez 


—-------— REM 


cmd reg 
Status_reg 
p_addr_lo 
p_addr_hi 


tthe tebe tr tert 


enter 


roller command bytes and masks (2EMEX) --— 
equ @&H 
equ 101148 s;read command 
equ 1¢12kh 
equ 122149 swrite command 
equ 18224 
equ 1¢ 
eau 2 PoEMMELO RICA 062 92 for 
sdrive 2 
EX Interface Controller Ports -------------- 
equ 7@E sctrier’s base in CP/M-86 
equ 714 
equ 72H 
equ 73H 


HHP HHH mt HHH FH LHe HH HHH HHH Here tee Ht tH HH serge Hite 
CPM DEN Ge SO PaG if ic -COLE 
Gd Viatlavel tanles in CPMMAS? - Cec 


HEHEHE HEE HEHEHE HEEL LEE REE EERE HEE REE E HEHE EE HH HHH THE HHH TH+ 


cseg $ 


ee 





ret 7no special action required 


? 
rxflop home: 
ret ynuO Special action fFequlred 


9 
rxflop_ seldsk: 
ret sno special action required 


= SS em ee SS Ss Se ee ce ee eo es ees ee ee ee es ce ee Ss eS ee SS ee Sc ge ee ee ee cs 


Peoop Sséettra: 
ret sno special action required 


y 
Pen lop S&tSec: 
ret sno special action reguired 


eee ee ee ee ee es es es ee ee ee ee es es ee es es es ae ee ee Os ee ee es a ee es a es ee es oe a a ee es ee es ee a ee ae ee 6 6 ee 6 6) ee ee 62 ae oe 


Paro p read: 


mov rwdir,@ 
e411 request ;z@et resource (SYNC .AE6) 
cmp unit,drivee HUPMeLOgrecalnarskt NO. Lor 
NZ ral ;sRemex floppy drive 2 {C:) 
mov ox, dk rd _cmdi ;set up to read drive i (F:) 
jmps Ede 
lo aa 
mov bx,dk rd _cmd2 7set up to read drive 2 
Rac: 
call build packet 
Call send pacxet ;sperform the read 
call tir burirer ;Xfr CPM buffer into memory 
Gai release >free resource (SYNC .AG6) 
mov al,result sreturn success/failure code 
ret 
a a = 
Mmerrop write: 
mov Ewa. ,.1 
cail request srequest ticket number 
cmp unit,drivee Hor Melos) Cel disk) NO. .70r 
V2 wrtl pheMex=itoppy drive 2. (Cy) 


eo 








* UV Lipa, Seti 





ls : a 1 
yr oh), 
za 


mov bx, dk _wr_cmdl ;setup write to drive 1 (B:) 
jmps Winitie 


we tl $ 
Mov Ox , ax wreemac Sete up toOuwrite drive < 
Minot c 3 
Gal build packet 
call Bt Deputies er 
call send packet 
call release ;free resource (SYNC .AE6) 
mov al,result s;return success/failure code 
ret 


SHEEP EHEHEEHEHHE HEHEHE HEH RKHHEHH EEE HEHEHE HL HEHE HEHe HHH He Ht Hetite 


REMEX FLOPPY DISK SUSROUTINES 


SHHEEEHEA HEHEHE HEEEEHHE THEE HEHEHE HLEH HEHEHE HEHEHE HHH EHH se Hignteteet 


“=? © 


build packet: 


push es ;save es register 

mov ax,cmemseg »set up es to address common 
mov es,ax »;memory EGOS: 

mov p_modifiers,bdx j;enter read code in pacxet 
mov p_status,@ »Cclear packet Status word 
mov ax, @@COE ;Clear register 

mov al,tracxk ,¢get track # 

mov Dot hack In0,4x ;enter track # in packet 
mov ax, @@00n ;set nead no. to ¢ 

add al,sector set sector no. 

mov p_ head _sect,ax ;put head & sec # in pacxet 
mov Dp mem addr,@i@@h ;address or CPM buffer 

mov p_msd,0@@eh COM burfer msd 

Mov p word count ,64 ;# of 16 bit words 

pop es 

ret 


— CE oe GC oe Ce ee GE ae ae GP ee ae ee Gs ees ee ee ee ee i ee i ee ee ees eee es eee ee ee ees ee ee ee eee ee ee ee OS eee ee ee ees ee ee ei eee ee ee ee oe 


push es 

Mov ax,cmemseeg common meMory sezemeat = Edee 

mov es,ax 

MOV G@xwent,tries ;loead count for retries 
sendl: 

7 al,status reg 

and al, dk rdy_mask ;checx interface ready 

cmp al ,@8=2 ;is it ready? 

jne sendl ,;i? not ready repeat 

mov al, ica 

Out cmd_reg,al sload extended address 

MOV ax, @0C4n »;packet offset 

out p_addr_lo,al »transfer low »vyte out 

mov ey nce 


124 





out meadadr Gia l ytransfer hi byte out 
emeck result: 


mov ax,p_ status ,;load status word 
cmp ax, O@@148 »;check for success 
Je Siiecess Tedd 
cmp ax, 800d ;check for failure 
june retry 
jmps emeck result 
retry: 
mov dk err_code,al ;save error code 
mov ax,@ »;clear status word 
dec Geren t sreduce retry count 
nz send pacxet aot ea” Unt ry sean hi 
mov result, @rF »;return failure code 
jmps dk execute ret 
euccess read: 
mov result, dou iheturn success code 
dk execute ret: 
pop es 
ret 
;7—— = ame ome ome aD = oe © oe = DD OO we ee et a ww eS we we we Se ee ee oe ee a 
Po ourter: sget data from common memory 


sand ioad into locel memory 


Dusia@s .! pushed s 
mov es,dma_ seg 
mov di,dma_adr 
mov ax,cmemseg 
mov ds,ax 

mov si,@1¢@n 

mov cx,64 

EMD. -EwatrT, 2 

We Lee 

Setresi, a1 ;set up for write operation 
mov ax,ds 

mov €S,ax 

mov ds,dma_ seg 


Ce ae 
as ; 
rep movs ax,ax mmove as 16-bit words 
pop ds ! pop es 
ret 


I al a oe Re ai ol aia oie OE a ial al alle ial ales ol alate lies oie ole it ia alate eo te i oe a ed eel oat 
} Data Area 
PPE PHA Peet HEHEHE PE THEE HE tHE Te HHH ete t eet tpierte ttt tte ree 


aaa" ------- CG rome ety Chemg pce Gone 
packet located in common memory at E@eu:co¢ce 


eseg 


L225 








pemodifiers 
bes tatus 
petrack no 

p head sect 
p_mem_addr 
p_msb 

p_word count 


dk err _code 
om cht 
result 
rwdir 


org 8004h 

mw 1 

rw oil 

re6«C(UC«dL 

rw 1 

Ewe. 1 

mw OL 

rw 1 
<< Mise 

cseg $ 

db JH 

db OVE 

Roe L 

EO. I 


fOr set of packet 


paumet10n8s Logical unit 
returned status 

»,selected track number 

selected head/sector number 
,ouffer address 

,extended bits of buffer address 
7size of data dlocx 


Variahvles---- --- - - -- - - ---- - ------ 


sreturned Remex error code 


so = read 3; 1 = write 





»;Prog Name 
>Date : 
sModified 
smritven by : 
>For : 


APPENDIX F 


— FF - oe = eee ee ae 


RXHARD2.AS6 (RKREMEX HARD DISK ACCESS CODE) 
13 October 1982 

Transfer Thru Common Memory/Ticket Sync 
Tom ¥. Almquist and David S. Stevens 
Thesis (AEGIS Modeling Group) 


;Advisor Professor Kodres 
;Purpose This code is an include file w/in CPMBIOS.ASE. 
, It contains the code necessary to access tne 
; REMEX hard disk drive. 
} 
} 
ee PGR GS.  eeemene ae  e 
;--- Disk Controller command bytes and masks (REMEX) --- 
ndx rdy _masx equ @8H 
hdk rd cmd eygu 13108 sread command 
hdk wr cmd equ 102¢h »write command 
ndk_ tries equ 10 
nead2 egu 3 sUry/M  loelical dsx* for head 

30 of KREMEX hard disk 
Bistr? equ 9 pO tat. Strboeet unetlon 
———.-- Riveoweldepertace Contrailer rorts. ===== aa a 
nok cMD reg equ 72H sctrler’s base in C2/M-&6 
hdk status_reg@ equ 715 
ndx addr_io equ 72H 
ndk addr_ni equ 73H 
ee OC ey oe oO. ———————— 
una equ byte ptr (3Xj j;name for byte at 3X 
pons i 2 Cau 164384 »>CP/M allocation size 
hstsiz equ 5l2 »;nost disx sector size 
mS. Spt equ 3s ;nost disk sectors/trk 
BS ol ik equ hstsiz/1i2& ;CP/M sects/host buff 
secshf equ 2 slogé(hstblk) 
cpmspt CquSaStole * hStspt ;0r/M Sectors/tracs 
secmsk equ astbdlk-l »sector mask 
wrall equ Jd »;write to allocated 
wera ir equ l pave FO cd rect ory 
wrual equ 2 swrite to unailocated 


jb 





SHEEHEEHHE EEE EEE EE RHEE FEE FE HEE EHEHEHE HEHEHE HEE FE HH HEHEHE HHH HE HH tT HHH 
; Divi Cieoreci ric Cops 

? 

? 


entered from the main CPMBIOS via label tadles 
HEAPRHEEHEE HEHEHE HEHEHE HEHEHE PEE EER THEE HEHEHE HEHEHE EH rH HH ete 


? 
> INIT sCalled from INIT 


Ct 


mea a a ee ae Se aE SE Se SE ca ame SP cee CO ae Ss oe ee iw eS ee oe SS ee SE SS EE ee SS ee ee Se ee SS ia SS SSS Se 


‘OME entered via nome label table 
Rxhard_ nome: 
mov ali,astwrt scheck for pending write 
test al,al 
IZ homed 
mov hstact,€ »>clear host active flag 


‘SELECT Drok entered via seldsk lavdel taole 
Rxhard selds«: 

mov Cig in. G 

MOV sekdsk,cl 

test ol jeer jG activation of disk? 

{ewe Comic. »no 

MOV hstact,@ syes 

mov Unecnt.v 


— aE a ee oe ae ee a ee ee Se eS Se Se a GS oe co ae ee OS SS SS 6 ee Sa Ss le es Ge OS ee a Se Ee ee ee Se eee 


SELECT eA enterd via seltrk lavdel tabdle 
Rxhard settrk: 

mov SOCK trike cy 

ret 


ome a ee ee eee Se eee ee ee eee 6 ee ee ew es ese © ee 6 oe eS ow eee SS 6 © ee oe = oe aoe ees eee eee eee eS aw Se ow = Se Se eee ee SS oe Se ee 6 es ee Se a 


‘SELECT SECTOR entered via selsec lavel table 
Rxnard setsec: 


mov seksec,cl 
ret 


DZe 





’ 


sr D entered via read label table 


-_— = ae ae) ee ee ee ee ee ee ee ee ee ee es ee es ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee ee en eee eee ee ee ~—~—e Gp ew @! ow a= 
. 


Rxhard read: sread selected CP/M sector 
mov unacnt,d ;clear unallocated counter 
mov readop,l sread operation 
MOV rsflag,l smust read data 
mov wrtype,wrual »;treat as unalloc 
jmp rwoper ;to perform the read 

$e 

sWRITE enter via write label table 

Rxhard write: swrite selected Cr/M sector 
mov readop,£¢ swrite operation 
mov Woy pes cL 
cmp cl,wrual swrite unallocated? 

A ez chkuna scheck for unalloc 


sywrite to unallocated, set parameters 


Mov unpacnt,(bvlksiz/128) ;next unalloc recs 
mov al,sekdsk ;disk to seex 

mov unadsk,al ;unadsKkK = sekdsk 

NOV ax,sextrk 

mov unatrk,ax ;unatrk = sektrk 

Mov al,sexsec 

mov unasec,el sunase€c = sexsec 


(SR SE al a ling Sm RT tn aa ain a wi no wad a ata wa Nr a a a a acl oe i 


; BLOCKING & DEBLOCKING SUBROUTINES 


SP HS Sa Gee as aN: Me wae Pal an nl nt lan all ln Noda li oil i lal a an a ol ool oo do a clin aa na ain a a 


Chkuna: pemeck (or write to unallocated sector 
mov ox,offset unacnt;point UNA at UNACNT 
mov al,una 
test al,al sany unalloc remain? 
pe alloc eee et Gt 

smore unallocated records remain 
dec al Funeen we= Unecnt—i 
mov una,al 
mov al,sexdsk ssame disk? 
mov ox, offset unadsx 
ene al,una ;sexdsk = unadsxk? 
goatee alloc (Skip i: Lot 


;disks are the same 


mov AX, unatrk 
cmp Amy, sektrk 
1 a2 alloc ;SKip if not 


;tracks are the same 
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mov al,seksec ,same sector? 
mov ox, offset unasec spoint una at unasec 
cmp al,una sseksec = unasec? 
Salve alloc ;SKip if not 
;match, move to next sector for future ref 
ale una punascec = uUnasce +1 
mov al,una ;end of track? 
cmp al,cpmspt scount CP/M sectors 
jo noovf ;sKip if below 
;overflow to next track 
mov una ,@ ,;unasec = 9 
ane unatrK sunatrk=unatrk+l 
moovi ; smatcn found, mark as unnecessary read 
mov rsflag,@ srsflagz = ¢@ 
jmps rwoper ;to perform the write 
alloc: ;Hot am unmallocated record, requires pre-read 
mov unacnot,d sunacnt = @ 
mov RST Paget srsflag = 1 


>Common code for READ and 


WRITE 


3adrop through to fwoper 


follows 


rwoper: ;enter here to perform the read/write 

mov erflag,2 sno errors (yet) 

Mov al, sexsec scompute host sector 

sud alae 

mov Cinwsec sit 

Snr alsiei 

mov sekhst,al s;nhost sector to seek 
sactive host sector? 

mov able: 

p monet. al,hstact salways becomes 1 

test al,al ;was it already? 

Az Pras 4 sli ieenost= iat. 2Ot 
snost buffer active, same as seex buffer? 

mov al,sexdsk 

cmp al,hstdsk ;sekdsk = hstdsx? 

juz nomatch 

>same disk, same track? 

mov axes tl re 

cmp ax, sextrk shost tr&k same as seex trk 

pa Z nomatch 


,same ais, 
MOV 


same track, 
al,sexhst 


same buffer? 


130 





Crp al,nstsec ;seKhst = nstsec? 


diz match sskip if match 
nomatch: 'MOnODer alse, DULL MOT cOnteot secur 
mov al, hstwrt . . 
test al,al ; Gievyy iburter ? 
jz filhst sno, don’t need to write 
call writenst yes, clear host buff 
Peens U 2 smay have to fill the host ouffer 
mov al,sexdsk ! mov hstdsx,al 
mov ax,sektrs I emovweast thnk ,ax 
MOV al,sexnst {f mov hstsec,al 
mov al,rsflde 
test al,al sneed to read? 
32 al elseaa 
call readhst 
moins tl: 
mov nstwrt,é ,no pending write 
match: : 
;copy data to or from buffer depending on readop 
mov al,seksec (mas 00d te ren imper 
sub al,l 
and ax,secmsk ,;least signif bits masked 
mov Cleat ; Sod Si u 
oe ax,cli jee = 27 ) 


,ax has relative nost ouffer offset 


add ax,offset hstbuf ;ax has buffer address 

mov Si, ax spout in source index reg 

mov di,dma_adr uses Diet 1S dest if reacon 
push BS ; 

push BO ,save segment registers 

mov ZS,dma_ seg 7set destseg to the user seg 


,OLI/DI and DS/ES is swapped 
,;if write op 


/ mov Cx; bee 2 ;leneth of move in words 
mov al,readop 
test al,al swhich way? 
jnz rwmove ,okio 22 read 

swrite operation, mark and switch direction 

mov hstwrt,l sostwrt = 1 (dirty buffer }) 
xche 51 mod ;source/dest index swap 
mov ax,Ds 
mov ES , ax 
MOV DS,dma_seg PSELUD BS,go fOr write 


EwMOVEe s 


ot 





eld 


rep movs AX, AX smove as 16 dit words 
pop ES 
pop DS yrestore segment registers 
s;data has been moved to/from host buffer 
cmp WEuype,wrdir »swrite type to directory? 
mov al,erflaeg ,;in case of errors 
* hove Peturn rw soo further processing 


;Cclear host buffer for directory write 


test al,al ;errors? 
ev return rw jsehoeit 50 
mov Hstwrt, 2 svuffer written 
call writehst 
mov al ,ertiag 
mecurn fw: 
ret 
’ ae ee ee eae ae eae eae ae SD eee ED Ee SE cee Oe ae eae eae eae coum cous STEP cae eae GET ee GED Gere GED coe cate GE eae GENT eee GED ES eee Pee ae eae Oe eae ee eee eae eae eee ee SE a ee ee me 
read hst: 
mov ndk rwdir,@ 
call request ;fet resource (SYNC.A&6) 
MOV byw ord cmd 
call ndk build packet 
call hdx send packet ;perform the read 
call hak etr bdutres 
call release ;free resource (SYNC .A&86) 
mov al,adk result sret success/failure code 
ret 


Write ost: 


mov Hd Ewa ok. 1 
mov ais 4d SK 
cmp al,user 
Hp aly wrt _err 
call request ;zet resource (SYNC .A86) 
mov bx, hdk wr cmd 7$et up write to hard disk 
cali ndk pduild_ packet 
call hdk xrr_ buffer 
Call hdk send pac#cet 
call release ;free resource (SYNC.A&S) 
mov al,hdk result PEEL SNeCCesS/iallure coce 
jmp We eet 
wet err: 
mov ox,offset wrtmse 
call pmse 
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mov al,@ffh PeeuUIrieerror to Cer/™ 
"on a ok =e 
ret 


SHEER HEHEHE EHF H HEHEHE HEHEHE HEHEHE HHE THEE HEHEHE HH rt HH rte +He ee 


; REMEX HARD DISK SUBROUTINES 


FHP EHEEEEEHHE HEHEHE EE HEHEHE HEHEHE EEE HEHEHE EH TH HHH HHH HH tee t+ 


hdk build packet: s;packet built in common memory 


push es. 

mov ax,cmemseg 

MOV esi, ax 

MOV Mar modifiers.5x ;enter reec code ih vacket 
MOV hdg status,d009H ;clear packet status word 

mov AX, ZO0@E ;clear resister 

Mov okey Site ver x jae brace nO. 

mov Dade Crack AOgAA) ; enter thace 20. 14 paecKnet 
mov AX, OGO@E ;clear register 

mov anwast.0Sx 

Sud an,headé saetermine head # 

mov AL,ast_sec ;set sector # 

add ax,l 

Mov hdk head sect,AX ;load in pac«et 

mov hdk mem addr,g1d0n j;address of CP/M buffer 
MOV hdk msb,¢cvceh ;common memory see 

MOV nemewond Cnt,ccoO 54 of 16 bit words 

poD es 

ee 


’ 
nd« send packet: 


push es 

mov ax,cmemseg 

mov es,ax 

mov MGR eCHbemak tries ;load count for retries 
send ndk packet: 

Lt AL,adkK status reg 

and MEG ekm 1Gy Mast yomecK 1Gteriace ready 

cmp AL, 2388 sis it ready? 

jne send hd« packet ;if not ready repeat 

mov Wee: 

out ndk_ cmd _reg,AL ;load extended address 

mov ax,O@v4n 

Out hdk addr_lo,AL ;transfer low byte out 

Mov Avi end 

out nodk addr _ni,AL ;transfer hi byte out 

e1eck adk result: 
mov ax,ad«k status ;load status word 
cmp AX, 00@1c- FponeCcK for success 





je hdk success_read 
cmp AX, 00004 Fomeck for failure 
ame hak SSerry 
jmps check_ hdk result 
nek retry: 


mov hdk_err_code,AL ;save error code 
mov odk status,@ ;clear status word 
dec adk cnt sreduce retry count 
sees send hdk packet ;if <> @ try again 
mov ndk_ result ,aFFH ;return failure code 
jmps ndk execute _ret 
hdk success read: 
mov hdk result ,g@3 ;return success code 
hdk execute ret: 
DOT es 
ret 
¢ —— ——--——------------ -- -— --- +--+ +--+ = + 5 5 5 = = = 
Geteexi tT buffer: ;transfer cata from common 


smemory to local memory 


push es ! pusa ds 


mov ax,cs 
mov es,ax 
mov diort set sas cour 
mov ax,cmemsee 
Mov ds,ax 
mov si1,d199h 
Mov CZe Zoo 
cmp hdk rwdir,gd 
jz hdk xfr 
Rene Si... 
mov ax,ds 
mov es,ax 
mov ax,cs 
Mov aS ax 

mae XPT: 
co iret 
rep MOVS axX,ax 
pop ds ! pop es 
re. 


embers Soak ee Se ee et te ey three 


} Data Segment Area 
PERSE EE EE ESE PEE HH EH EEE HH EER FREE EH HHH et mt eet 


~~ Rome. J UGer lace eeded6 == Ha Soe = 
»;pacaét built in common memory at 3000:0004 


eseg 
org @2@4h ;offset of pacKxet 





ndk modifiers ry 1 
hdk status mw ol 
hd track_no Sy Oi 
hdk head sect PW ee 
ndk mem_addr Ewe 1 
hdk ms» awe) 1 
ndx word_cnat Ew Ad 
cseg > 
as gee Misc 
hdk err code dd 02H 
mom Cnt dp 28 
ndk result i st 
ad«< rwdir Poe ae 
See, asx rb iL 
sex trk rw i 
Sem SEC rbd af 
hst_dsk rbd ] 
eu trk rw 1 
mete Sec rb iL 
sek_hst rod if 
seact rbd 1 
Mmopewrt rob 1 
una cnt rd it 
una_dsk rb i 
una _ trk rw 1 
tee sec rb it 
erfiag ro 1 
Eomerae rT 1 
readop fr 1 
Wiabype rd 1 
dma off rw 1 
Meweout rb Si 512 
wrtmsge db 
d> Drive’ ,2 


pyLunetion & leniscal unit 
sreturned status 

sselected track number 

sselected head/sector number 
,youffer address 

,extended bits of buffer adcress 
sSize of data block 


;returned -Remex error code 


;success/ failure code 


disk number 
track number 
s@ctor number 
disk numbder 
track number 
s@ctor number 
;seek shr secsaf 
70H0St active flag 
snost written flag 
pina lwvoe mec. cit 
;iast unalloc dis« 
phast umalioc track 
Tiast Und oe MSector 
,2ETOr Un eLOort. ne 
»read sector flag 

;1 if read operation 
ywrite operation type 
,last dma offset 
shost ouffer 


,;Sseek 
»;S$eex 
,;seek 
»nost 
;nost 
»7nost 


cr, lf e¥rite Access Not Permitted On This’ 
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APPENDIX G 


—_ ews e- aw =e © — — 


The following disk definition statements were used in 
this thesis. The command GENDEF CPMMAST.DEF is executed 
to produce CPMMAST.LIB which must be assembled into the BIOS 
using an include command. 


disks 7 
diskdef 
diskde? 
diskdef 


021,26, 0,1026871,52.0;2 

ee) arya 

2 
diskdef 3 

4 

3) 

6 


6,6,1924 ,2435,64,64,2 


pLoOeO ,16064,275,228,0,1 
diskcef 
diskde? 
diskdef 
endef 


7° baad 2 =) ° @ . 
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IX 3 
NG OF CPMMAST.LIB 


When GENDEF is executed using CPMMAST.DEF as the source 


file, CRMMAST.LIB is created. The listing which follow is 


the code generated by GENDEF and must be assembled into the 


BIOS with an include command. 


we we 


DISKS 7 

dpbase equ 9 szase Of Disk Parameter Blocss 
dped dw X1td,d09Gh r;lranslate Taole 

dw YV0OCh ,gUOUn socratch Area 

dw dirbuf,dadpbdd@ Sar Suit Farm Block 

dw csvg,alva sCheck, Alloc Vectors 
dpel dw xlt1,vd@@Gn »>Translate Table 

dw OUO8Gh ,C@uven socratca Area 

dw deer our vaonel sUrmeonit , carm Block 

dw esvl,alvi »>Check, Allocs Vectors 
apec dw x1t2,3000h »>Translate Taole 

dw 00dGh , B9JOdh socratch Aree 

dw dyeput ,apoc Der Sotit © = rar 3h0Cr 

dw csv2,alve FONnecCt. sAlioc wec.Ors 
dpes dw x1t3,d000h slranslate Taole 

dw QG098Gh ,@0eun socratch Area 

dw Quer gut ,ac03 pole Sut. Sonn Piock 

dw GSivopaly oO F;eneck, silloc Vectors 
dpe4 dw x1t4,0000n »sTranslate Table 

dw 8600h ,d000h socratch Area 

dw dirbuf,dpb¢ sour Sure. Parms Lock 

dw csv4,alv4 >Check, Alloc Vectors 
dpesd dw X1t5,d00@h >Translate Taole 

dw OBGOh , 308K socratch Area 

dw dee Dut. d pol ;Dir Buff, Parm Block 

dw ESVS,divo sCheck, Alloc Vectors 
dpeé dw x1t6,@e¢€Gh >Translate Tabdle 

dw SZO8Gh , 9OAGh socratch Area 

dw dirbuf,dpdtb UN Butt carm. blocs 

dw csv6,alv6 »>Check, Alloc Vectors 
; Des uor O,1.267,05twe 4. (1. o2,0ye 
dpba equ Ort set > >Disk Parameter 3locK 

dw 26 poreC Fors rer Track 

dod ) poLoOcK Shift 

dd a s>3slock MasK 


Vo 








xltd 


met l 


Q > extmt Mask 

7@ >Disk Size ~ 1 
51 >;Directory Max 
128 pRLLoCc? 

g ,aLlacl 

g ;Check Size 

2 sOffset 

offset $ sTransilate Table 
lee ro, + 

eines (een= 


15,14,15,16 
Wi es BU Sh IGS) 


Clee , cosce 

(eae) | AS 

9 auetocatLon Vector Size 
fy meme CK  VNECLOrvs1Ze 


DISKDEF 1,1,26,6,1924,245,64,64,2 


offset $ >Disk Parameter Biock 
26 ssectors Per Track 
S sFlockx Shift 

7 >BSlocKk Mask 

O ;extnt Mask 

242 PS Go Ze 

63 TOE eCuOry tas 

192 sAllocd 

¢ sAllocl 

le »>Check Size 

P »sCPFset 

offset $ ,;Translate Tadle 
ee (are PES: 

Zoo eile 

VES as ike Hae tee, 

Cues e gle 


AED) AS) lee NV 
18,24,4,12 


Eee 

on sAllocation Vector Size 

16 TOReCK VECTOR ol ze 

EDS JOT 2 re 

ahjejloyel seqGuivalent Parameters 

alsl sosame Allocation Vector size 
cssl soame Checksum Vector Size 
Gl isel soame Translate Table 


PRUE. i yt 00,0 puooe+ 240, leo ,0 1 


offset $s ;Disk Parameter Block 
1356 pyoectors Per Trac« 

fl paocke oni Et 

Lae s;slock Mask 

z ;extnt Mask 

C74 joese 5126 — 1 

ILA pOirectvory Max 
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ab 128 sAlloc@ 

db M, yagi OC. 

dw 3 »>Cneck Size 

dw 1 sOffset 
mito equ Offset.> ;TranSlate Taole 

db 1,2,5,4 

db Onion © oS 

ab Oreo, ls le 

db ones, 1,16 

ab ies 719,29 

ab Clea, ooyes 

do 2e,20%447 ,2c 

a (AS) Go oR bys 

db Ge) 5 OYE Ae hs Wile: 

do 37,38 ,59,42 

db 41,42 ,43 44 

ad 45,46 ,47 ,4€ 

elite aoe, OL oe 

add Jono + yo 7 l0 

do SGC 750,08 

ad Silo 2 00,04 

ad» 65,66 ,67 ,68 

abd 69,/70.71,¢%e 

a5 fio ey pom ide: 

db 77,78 ,79,39 

db Sinwe 2 coset 

ab So7eO,c7,ce 

db 89,99,91,9e 

db 95,94 ,95 ,96 

ab 97,98 ,99,19¢ 

db loli de 105,194 

Ale VOs,126 ,1267,18e 

a5 179,110, oie 

ab Pore Lore 6 

d> Vibe wileS al ey) 

db Vallee wise fee 

db 29.) 2enh27..28 

db W253 eboC wlele woe 

db Loo oe! 55. 50 

db 1S pos yhoo ase 

db 141,142 ,145,144 

db 145,146 ,147 ,146 

add 149,152,151, 52 

el Newey Los hoes) oo 
alsé eq Gye joke cadtlon Vector si1Ze 
css equ 2 sCheck Vector Size 
; DISKDEF 4,3 
dpb4 equ dobé »;squivalent Parameters 
als4 eq’ als joame Allocationy Vector Size 
css¢ 2qu c$30 s;same Checksum Vector size 
x1lt4 equ Sete yoame Translat=2= Table 


j DISSDEF 3,5 
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’ 
e 
? 
e 


9 
vegdat 
seer Dut 
= eS 
csvZ 
alvil 
csvl 
alve 
Sov 
alvd 
csvd 
alvéd 
CcSV4 
alv5 
esv& 
alvé 
GS-0 
enddat 
datsiz 


equ 
equ 
equ 
equ 


equ 
equ 
equ 
equ 


dpos 
als2 
C535 
Tito 


Diokver 6, o 


dpbs 
als3 
csscé 
Eco 


ENDEF 


shbGuivalent Parameters 


ssame Allocation 


NeEeLor S172 


,yoame Checksum Vector Size 
,oame Translate Tabdle 


sAquivalent Parameters 

syoame Allocation Vector Size 
,yoame Checksum Vector Size 
ysame Translate Tadle 


Uninitialized Scratch Memory Follows: 


egil 
eS 
rs 
ES 
i> 
cS 
rs 
rs 
eS 
ES 
rs 
rs 
rs 
eS 
rs 
rs 
equ 
equ 
d 5 


offset $ 


12& 

alsd 
css@ 
alsl 
cssl 
als2 
GsS2 
als3 
css 
als4 
css¢ 
als5& 
css3 
als5 
cssc6 


Cteset Ss 
offset $-beedat 


0 


sotart of Scratch area 


poieectvery 8ufrer 


7h oC 
»>Cnheck 
s4lloc 
»>check 
; A LLOC 
»Check 
»Alloc 
»;Check 
reek ene: 
»Check 
yAlloc 
»>Cneck 
pA LioOc 
>Cneck 


women Of oCratcy 
-omae Of Scratch 


Vector 
vector 
Vector 
Vector 
Yector 
Vector 
Vector 
Vector 
NeCcor 
VEeeror 
Vector 
Vector 
Vector 
Vector 


Area 
Area 


sMarss End of Module 


146 





APPENDIX I 


— ew ee oe om ee ewe = 


;Prog Name : INTELDSK.A&6 (MDS S. Density Floppy Routines) 
;Date >: 9 Aug 1982 

Written by : Jim John, SMC 1277, 649-9592 

sModified by: Tom V. Almquist and David Stevens 


;For > Thesis (AEGIS Modeling Group) 

sAdvisor SP eSOLressor M.u. COttOn 

;Ppurpose : This code is an include file w/in CPMBIOS.AS6. 
} MusCOn Gams tde routines for usine tie MDs 

; Saas le  Pepsity flopey visk. lt is conf teured 
} forsa single iS0B S6/i124 ane does not use 

} common memory for I/0. 


sport addresses 


dase equ d7é&h ;iSBC2G1 port address base 
maeport ecu basetl ;read result type (input) 
Gio por t equ baser+s ;read result byte (input) 
resport equ base+? sreset iSBC221 (output) 
ds port equ base ;read suosystem status 
je pul) 
reanpor t equ base+l >write iopb addr low 
Pout put) 
iahport equ dasere jWEve LOpb, addr higen 


; (Count) 


;command codes & masks 


rdcode equ ¢ ;read command code 

wrcoce equ 6 swrite command code 

cweode equ 80d >Channel command code 

tc) 1 t equ 4h sinterrupt bit mask 

retries eg uel 2 FPORtarsk 1.704. SELOre error 


Pe a al aie ate oie ale alte alts ale linia nan adn ale iin in ai aie sina oie aiteads ain ae ole cial ani aeals aie aie alioata aie itt ole aia aie anata alia iain sieeieatia ake oe aia aie ee 
} ENTRY POINT ROUTINES 

® 

3 


Pb te Re HEPES EHH PEE HEE TEE EEE HEE RHEE EHH PH HHH rH ret ett tt te 


(oe ee 
Mecslas« init: ;initialize disk controller 
pactually done by iSBCE6/i2 monitor 


Pew 
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——— i a Ee a =—_ = aD aap ee aap Gee GD ee C= amp ee cm Se owe ee 6 ae ae a ane ee Gee GP eee GED CED coe ee Gee Ge oe Gee eee eee SD 6 op 6 S aap SP aw Gee ow SES aa 4 ae == 


ren 


bd oa coe eee ae ee Ge ae ee ee ee Se ee ee ee ee ee es a ie ee ee i ee 0 ee ee ee ae = eb eee oe ee oe ee ee ee eae ee eo“ eee ee Oe eee oe 


’ 
Pepe lLaSK eSelaGsks . 
ret 


o— ee Oe ee ee ee ee es ee es es ee es es ee es ee ee es ee ee i ee en ee ee es ee ee ee ee ee ee ee ee ee ee ee ae ae a ee ee eee eee oe a Se ee S ae 


set 


Ge cee? oe coe GD = Ge eee ee ee ee ee i ee Oe oe oe ee ee es we ee ee es ee ee ee es ee ee oe ee oe es es ee ee eee ee ee eit ee ee oe ee Oe oe 


Pet 


om ee ee eg ee es ee ee ee ee eee ee eee ee ee ee ee ee ee ee ee a 0 ee ee ee Se ee ee a =? ee ee oe eo ee ee ie ee ee ee ee = oe = oe 


mov cl,4 

mov al,unit ;comdine disx selé€ction 

Sal <al,¢l ;With opcode 

or al,rdcode >to make ie command for read 
mov io com,al poOtmlG lawecond wore of 1000 
Cael ase = 1-0 sand execute it 

ret 


mov cl,4 screate io command for write 
mov al,unit 

sal al,cl 

or al,wrcode 

mov i{o_com,al 

Gave dst. 6 340 do it 

ret 


SEH EE RHEE EE EHH EEE HEHEHE HEHEHE ARTE HEH PH Herm tHe Het tet 


, SUBROUTINES 


PI ll ae ol a ne ll al a alate oi in le inal aie ae aia ican ale a ala in oie ie le in ala ln ahaa ian ain aint oie oie aie olen in ok ote ieee alnale aicnein ate he ake he de 2 


gore, 10: ;execute disk read or write function for 
plooeevylivecnunoller. Sets wp remainder of 
siopb and sends its addr to the controlier 
»;then polls for a response and checxs for 
pertor condit loas. 


mov io_chw,cwcode 7set no wait code for channel 
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) 


Mov 
mov 
MOV 
mov 
mov 
mov 
mov 
sal 
add 
mov 
mov 
mov 
Oks ina 
ea 
TOV 
mov 
sal 
sllalaat 
out 
mov 
sar 
out 
‘obs eae in a 
and 
G2. 2G. 
in a 


Moms cst 
a, SECLOF 
io sec,al 
al ,tracnk 
io trk,al 
cl,4 
ax,dMa_ seé 
ake 
ax,dma_adr 
io _adh,an 
io adl,al 


;transfer 1 sector 
;set up iopd trek and sect 


srecombine dma seg and addr 


MSetelt in “addr word of iopb 


tCeyecut,retries 


Ler woot t 
iy) Peer t 
cl,¢ 
azx,cs 
Gar OL 


tc uear controller 


jee eh oress. Of i009 


Tt 


am, Oreset iop5> 


Paiiport,al 
Clio 

ak. CL 
lahport,al 
la sueort 
al, imei dit 
Loz 

irr Geo rt 


Or taieaa) 


ee al 
ile ars! 
imps 


103 
io, cLOwOr t 
dio¢ 


GO. s la cat.  Toport 


or a 
joe 


dec 

pda 

or a 
dio6é: ret 


weyecnut rb 1 


eat: 
106 


Cry (Grrt 
dot 
E-error 


s;and send it out 


(ice OorecOnerie hr taterrupt 
scheck completion code 


potabucmenesd., Lenore sresul t 
sand retry 
foueGe sro result 


sret with al=d3 if no error 
;error if we got here 
decmt count and try again 
try again if any left 

set permanent error codé 


Pi alae lien alte sleet alte alin a alta ale ain ale ait ial itr adie alleen alien aie alten oi site cheat sie sina ote alten ohn ain ole in ain ale aia ainetaateningiionte semineliaie taste an sh ane 
; PRIVATS DATA AREZA 
GEE PE HEHE EHH HEHEHE THER He HEH pH eet EH HEHE HHH HHH Ht te HH Hert — 
iopb Eo 7 ;i/o parameter dlock 
io chw equ iopod s;lopd channel byte 
momcom e€G2 iopb + 1 scommand byte 
io nsc equ iopb + 2 ssectors to xfer (always 1; 
moor k e@€gqu iopb + 3S ,selected track 
10 sec equ iopd + 4 ;selected sector 
, 10 adl equ iopd + 5 sphysical address for S$20291 IMA 
lo adn equ iopb + 6 


jo Sk EGror retry counter 
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ix J 
PROGRAM NG OF LDCPM.A86 


LDC PM .A86 

T.V. Almquist and D. Stevens 

This program reads the file entitled 
CPMSLAVE.CMD into common memory beginning at 
location B80@:500. 


»>Prog Name 
pWritten by 


oe ee 00 8 8¢ 


we we we 


csee 
org 018¢h 
jmp start 


BAK AK HE ARS BENE AS HE AE BK BK OK AE SIE EOS OR OS AE IS OE AS AS AE OE EK SR AS IE FS HK OK HE OE AR OIE AS AK HE OI OE OE OK OK OE OIE IS AS OE RSE OK AK OE 


BqQuates 
HERE HAE AE HONE EK SIS AE EO AK BE CE OE AE OE OK IE OC OE KBE IE FR NE IE OK OI I OK I OIE OK BE OE 2K OR OK OK 2K OE OE OK NC OC Oe Oi ie aK EOE 


or equ edh ;carriage return 

if equ dah ;line feed 

drive equ @J94h ptareet Or/ i ative # 
HaoS Gent equ 224 pinterupt wector 

potrr eau 9 f;Drlmt. Serine tinct Lon 
seldskf equ 14 ;select disk function 
openf equ Lies ;open file function 
readf equ co ;read function 

dimaf equ 26 ;set dha offset function 
dmabf equ ay ;s@€t dma base function 


she Be St ae SRE Ee Ke DRONE A RE IKK A Be OE A I AE KE EE ONE NE a BE ORE OE Se ONE OK OK SE ge Ofc ae iE oye BIE ae afc OK Sk oe ae as Oe ee NE OK OE OK aE OK AK OF a 


; 
; Subroutines 
i BK BE AS HE NS HE HK She AE TK SK THK IS OR IK NE RE NS HR OK IE NS HE HE OS ONS IS HS OE OK BIS HE AS NS OS NE OK NK DE AE OE IS SKC OE OS HE OS SIS OE ES OR EK AEE OK 


seldisk: ;select target disk # 
mov elvese ld saf 
mov ay ,dirive 
jmp Sys VEC 
? ee Ss SS SS SO eo Sr eS SSS SS SS Ss ee SH BS SS BS ar 5S SS a BS SS SS BSI OS Sa SS a Oo ee SS SSeS See ea 
openfnc: ,;open file denoted in fcbd 
mov cl,openf 
mov icenOner set fc 0 
jmp Sy Sav ec 





eet 
— 


setdmabd: 7set dma base address 


mov cl,dmabf 
jmo SsysS_vec 
; ome Ge ee ee ee ee ee ee ew ee ee 0 ee ee ee ee ew ew re Oe oe ee ee oe 0 ee ee oe = wr ee 
setdma: ;set dma offset 
mov er,amaf 
jmp sys_vec 
) Sa cg co cm cam ee cee ce cr ee ce eee ce re ce ee ce ee ee ee ee a ee we i we wr wr ee oe 
read: sread 12€ bytes from file 
7 bn, eo 
mov dx,offset fcbd 
mov cl,readf 
jmp SsyS_ vec 
’ ee ee ee ce a ce ce ee em ce ee ee gee ee re er we ee we ee ee ee we ee we we ee ew we we we ee we ee we ew = 
msg: sprint a character string 
send of string denoted by 2 
mov Ciesos ur ft 
jmp sys vec 
; ee eee gon ee es as ene Ge ae OD ee ee ce ee ee es ee ee ee ee ee ee se es ee es ee es 0 i es i a ee ee ee 
SyS. VEC; jpexmecutLe Odes function call 
int Nao Sao t 
ret 


ASME AS Ae BE OM HE ae HE OA ae Oe OA ae OE he 2c DI OK fe fe Ae he aS ahs OR Oe fe he She OE ak Oe He ae Se ae oe Oe Oe ae aE OK ae a ake ak oie aK ok ie ak he ate ke ade a ote 


j 
j Malin Program 
g SIE RE BE OE REDE RE 2 SE BE SENS BK BK OIE I 2H NE OK AC 2 he AE 2 2 OK SE OK 2 BRE NE HE OE NE He Ee HE ae Of aK SCS BA OK BR OK A 


as 


Stert: 

call seldisk select desired disx 
cail openfnc ,open file 
cmp ae 255 pia eo mot. tf Ound 
se eon 
mov axoriset nofile 
call msg sprint error ms¢g 
jmp stop 

cont: = 
mov dyecs’. - ;save 1st page in local 
quill setdmab ;memory 

; mov dx,offset pagel 
call setdma y 
cali read sread ist page 





»;read file into commom memory 


mov dx,@e@O¢h 3;set dma base to common 
Cay setdmab smemory 
mov dx, d500h ;desired offset 
reacfile: . 
call setdma 
push dx 
call read »sread 1i2& byte page 
cmp al,dih ;read complete ? 
je done 
cmp al,@@h ;repeat 
je contread 
mov Qxmeorfset rerr ;o0thenwise priat read error 
Cali msg 
jmop stop 
comtread: 
DOD dx 
add dx,d080h ,;increment dma offset for 
jmp readfile snext page 
done: 
mov de, offsetetmse ;print completion mse 
€all mse 
stop: 
mov Gly ood peewuaen CoO Crm 
mov d1,@6h 
int odos_ int 


; eS AT HK BS BS HT HS AE AS AE AS BS AE AK AK OK AE ES SYS AS OK EE OR OR HK OK IS EK OS EE AE EE AE OK AE SE EO OS IS OE OS NE OE OK IE AE AT REE 
) Data 
0S HE NE a HE A a HE SIE RCE OR a BE REE RA AS ae a BE RE Ne CH he ie a he ae alee 9 a AE aK Re ag a ONE a Se a a a aE aE Ne 2 a AE 2 3K 


nofile db CrelL. GeMomAweeOMD Not Found On This Distt ~ 


rerr Gd GEelte head ar rors, 
fmse db cr,lf, CPMSLAVE.CMD Loaded into Common 
d> “Memory$~ 
me dd Bee COMSDAVE . CMD’ ,0,0,0,0,290627 .9,.0,9.0,0 
ab 3) Ga oC a se, 
pagel rs ize 
db 2 
enc 
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APPENDIX K 


— OP ce ee ee oe — 


PROGRAM LISTING OF LDBOOT.A86: 


LDBOOT.A&6 

T.V. Almquist and D. Stevens 

This program loads the boot loader into 
common memory and is used dy slave c6/12As. 


;Prog Name 
sWritten Dy 


PAK AEE AE Ae SEAS AE AE TH AC SH A AS HE AE BRS AE NG OK OE OE EE OS NE OS ENS OK BEE A IS AE OK OK OS NE OE AE OK OK AK ENE OK OE AE OK AE AS AE AEE OK OK OK 


Sie 3 afc BE AK ae OE 2 I ae BE BE OK ae Ae BHR BC OK OE OE BE NE BR OEE ae GE CE af a he DE ANE BE I UE he OK NA AK fe fe SIC ake OIE IE okt he ote ae iC a aie ae ake ake 


Bquates 
SCRE OE AE ate aie Bie AK ots TIE IK NE HE SHE He HC OK HE HE OK BE XE SE NS HE NE OIE BIS BE NE BC ARC IS SE ONE IE AE NE BE BE ORE OK OE BC HE ONC OE 29S OEE OE HE OS EOE HE OK OS 3 


we *®e¢ we 


Cis equ ddh »;Carriage return 

lf equ Jah s;line feed 

drive eq. 0E@C4h ;target CP/M drive #4 
odos_int Pau crt ,;interupt vector 

Bsurt equ S pom t. Stine Luncotion 
seldskf equ 14 Fselect disk function 
opentf equ 15 POveD tLe fuel! os 
readf 2qu 29 ;read function 

dmaf equ 26 ,set dma offset function 
dmabf equ el 7set dma base function 


BE HE AR IE HE HR HE AK AE AES HE ME 24S AE IE HE IE AE HE YS AE EK AE OE AE BR A TE AE HE AS AK AE 3K HE NE IS HE AIRE FS AE SE OE Se OK SE ORK SK OK EE 


) 
; Subroutines 
oN NOE HE BE BK BK BE RESIN OK OK SICA 2 aK He RE SO 1 I 2 2 A DE BK IE 9 BRE OE NE BE BE NE REE AE CAE RE OES OK RECO OEE OK KK 


seldisx: ;select target disx # 
MOV cl,seidsx? 
mov ayparive 
jmp Sys VEC 
; oo ea SS a SS Sa Se a SS Sa Se Oo 
openfnc: ;open Pile denoted in fcbd 
mov cl,openf 
mov Gxyorrset fe 
jmp Sys vy eC 





setdmabd: 


cl,dmabdf 
sys_vec 


cl,dmaf 
sys vec 


adx,o0ffset 
cl,read?r 
sys_ vec 


»set dma base address 


a a a ae ae eo ene oem SEP ee Gee Ge ose cee Or oo ew eee SS ee © a a eee ee ee ea ee es eee a ee Ge GS GE Ea GS GS GS a SE Ge ae GS San TPG 6&2 SP ene = = eo 


alae | 
(G 
Qu 
Qu. 
> 
nN 
08) 
cr 
ce 
ct 
m 
" 
Van a) 
“3 
Oo 
= 
re 
p< 
| od 
m 


woe Co 


a — Ee ee ee es Oe ee ee ee ee Cae eee ee eee ee eee ee ee ee eee eee i ee ee eee Se ee Oa SS a cee ee Ge a 


oa ee ee ee ee ee ee eee ee ae 


call 
call 
cmp 
4) NS 
mov 
call 
Jmp 


cont: 
Mov 
Cadi 
mov 
Gare! 


call 


~—e OP eww Gee ew eww 2 ews ee 


ve a2 


REA HERE HE RE RAK Re OK HE EE 


ClenbS UGE 
SVs vec 


bdos int 


sprint a character string 
;end of string denoted by @ 


— 2 ae ee ee eee ee ee oe Gee OF eee SO coe OF ae ere ee ee Gee Gee ee eee ee ee eee eee ee ee 


sexecute vados function call 


BE HE AKO AE AS OHS AS AE OE RAS AE AE TE EAE OS OS AE AE AS OK TK AE OE AE ES AS EK ASS EE OS EAE OS 


Main Program 


seldisk 
openfne 
sll 4 ale 
Cont 
dzx,offset 
msz 

ston 


ees 
setdmao 
Ge or 1 5et 
setdma 
read 


BH HE HE BE EE HE AS HE AS AE DS HK KE EDK IK BYE BK SIS AS BE AS IE AE IE SIE IS AE AS HS AE SIS AS TS EK OS OE OK NE AK OK OK 


;select cesired dis« 
,;open file 
(te tee not found 


nofile 
sprint error mse 


;save 1st page in local 
smemory 
pagel 


;read 15t page 





,;read file into commom memory 


mov ax, de@O@oh ,;set dma base to common 

call setdmad ;memory 

mov dx,0420n sdesired offset 
readfile: 

cael 1 setdma 

push ar 

call read ;read 125 byte page 

cmp al, 31h ;read complete ? 

je done 

cmp al ,d@h ;repeat 

je contread 

mov dx,offset rerr ;o0therwise print read error 

call ms2 

jmp ston 


contread: 


pop dx 
add ax, 38dh ;increment dma offset for 
jmp readti ie snext page 
aone 

mov dx,offset fmse sprint completion mse 
Cail mse 

stop: 
mov cl,@@h Precis to. G7 
mov d1,d9h 
nye vdos_int 


; SK A AS HE AS SK KE BS AE TS SE AE HS TE OHS IS AK OS IK KE SHE SS ONS OE HE OIE NS OK NS OK SR OS OIE OE AS HS AK OE IE AE OE OS OIE OS AE OS AE OS OR OS ARS OK EE 
? Data 
; BH OR BS HE HS OR OR IS HS FS AE SK OK TE SE IE NS IE NE OR OL BH OK OE KS OK SE AK IS SK NS ENS SE HK OE OEE OK HS HE NE OK AK OS EE OS SiS a HR AK IT 


nofile db Caer OO] eM iGtmeound On this Diss 
mere ad GCrlit, Fead marrors 
fmse db cr,lf,°BOOT.CMD Loaded into Common Memory’ 
fico dd 34, ° B300T 7 OM) sand - Cal Oeoy Omrw oid 7 ocd 
oe U.0 Ae Oe yo ao 
pegel rs ies 
db g 
end 
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APPENDIX L 


eee - 


PROGRAM LISTING OF BOOT.A86 


BOOT. ASE 

T.Almguist and D. Stevens 

16 October 19&2 

This program is the boot loader used by 
Slave 86/12As to load CP/M-86. 


sProg Name 
sWritten by 
>Date 


ee @0@ e@ @8@ e8¢ 


wet EAE CN RAE ERENCE RA SEES ER BH SNE A AC OR A OC ENE 
} Zquates 
o BEE 3K IK OE AK SEE REDE RE HE 91 HE OK OIC SK IS OR BK OS BKC BI SK SE BE a OK OE BEE BK BR SE ANE NE 2s HE NS 2 ORE OK GIS ASAE 2 RE I OK OS BK AE a 
load_ addr equ 84ddh 
cpm_adacr equ @58Gh . 
gOS 918 DK ICAI AEE SK 9K SIE CAR A NE BK AE RE HE NE DK BE DR OS CPR AE AR DI OK EA OEE A OS aK OK BAC A OS OO AC CE DEE OS 3 DD OE 
; Main Program 
5 RAE BEAT HE AE AR AE OE SAE AE NK OE OE AE BE HE TE EAE AE HE AE AS BK OS AC SS AE 3S AS OS EAL AS BEE AS BK AE AS AE AK OK AS AS OK IK OE KOR OS OK OK 
cseg 
cail request ,fet ticket number : 
mov -ax,Jd4dh ;set es to CP/M Segerent # 
mov 25,ax 
mov C1. decor »set desired offset 
MOV ax, de ddggh set ds to common memory 
mov ds,ax »,sezmMent #F 
mMOvV Si, Cpmuecacr ;CPM.SLAVE offset 
MOV cx,ilaJddh snumver o? bytes to move 
Cid ;z:rom common memory to 
rep movs ax,ax ;local memory 
Cau release »;increment server # 
jmpf dword ptr bios offset + load addr 


s;transfer to CP/M 


6 BEE BE HE HEHE BC OH IES SEEN AK BI HE BEE BK OE AK TEAK BE REE BE BS REE IC OE OE OS SR OI ORE DE SIS EK OS BS BE OC AE OE SK SEK CK AE OK OE 

; Include File 

oR AEA SEO Ca oe 2 OE OR aK SIC EK IE RE eS BK BE a 2 OE OE OO aeees ste ote ote ate a oie Se ek ak ec oK oe ok 
include sync.a&6 sfor sharing common memory 


HE SE SIS SS OEE Se RAE EK RAS OK AS AR SK 2 2S OS HE ES OE 3S 


2¢ 


S4C OAS OE OE OEE oe BE SES BR He SNe She oe ie he She ae OAs BIS fe 3 He ONE ae ok Cafe ok afk ate afk ak 
DE ONE Oe SE ONC OC TE a aie oie ie abe a a ahs ie RE Be a 2K af BE ate ale OI I a Of He 


bios _orrset dw L2O0Gh jce/ jump vector 
dios see dw c¢4gh 





- 








;Prog Name 


’ 


>Date 


sWritten dy 


w?2e¢ we we 


’ 
e 
; 
e 
; 


BEAS IE AE AS AK IS 


AEE HE AK AE AS 2S 


busy 
ndsxs 


ME AE 9K ASS 


2e HEN 3,5 


cseg 


APPENDIX M 


oe eee ew ee 


ee oo 


PROGRAM LISTING OF LOGIN.A86 


LOGIN.A&6 
15 October 1982 


This program contains the code necessary to 
permit only one user at a time to be logged 


> T. Almquist and D. Stevens 


on to any I/O storage device. 


3 


Cdals Off 
equ 7 


BS AE AE ASK AS FS SS AS AS TE HR AS AS AS AS AS BIE SE AE EE AE AE OE SIS OE TIS ISAS OK OE AS 


No AE AE HA AS AE BS YS AE AS AEE AE AC AL HE NE AK SS AE 2 AE AS OK SE ASAE AS ASK OK SE 


»>dusy indicator 
snumoer of CP/M disks 


she 6 9k BIE OYE AC oft OA ig OC Ne NCE OK hs BK SEE OK OK NE A A OE OEE Se a BE OE SC OE KC OR OIC oe eC Oe ae Oe aK 


Subroutines 


BK AK AE AE KK OE OK HE IS 2S AS HR IS AE IS BIE OE AS IE AE AK OK OS EK OK AE OT IK TE AS OK AK BIE AS AK AS OS AE 3 YE OK AS 


? 


es 
ax,cmemsegs 
es,ax 


bx,offset logmsge2 
PMSEg 

conin 

al ,dih 

logd 

al ,34n 

logd 

console,al 


bx,offset logmsel 
pms@ 

Comin 

al,4ih 

leet 

al,4¢h + ndsks 


ree 
user,al 


@ 


set up to address common 
smemory 


;zget console number 


sret console numbder in al 
,;ensure response is between 
;L and 4 


»save console number 


sinital login mse 
sprint message 

»;eet Login disk 

»;within range defined by 
FORMAL. DEE 


sgreater tnan 2: 


PSGELO upper ni dole 
»normalize to zero 
»save login user disk 


,;aetermine if disk is free 


XOTr OX, Dx 
mov bl,al 
mov al,busy 
lock xchg al,logtol [dx] 
test al,al 
Jz loge 
cmp al,console 
HO geoeS tOre 

log2é: 
xOor 0x,bdz 
mov obl,user 
mov al,console 
lock xche al,logtb1 (bdzx] 
jmp log_ret 

restore: 
lock xchg al,loetbl [bx] 
mov ovx,offset logmsg3 
call pmse 
jmp loegl 

moe ret: 
pop es 
bee 

) ete OD res Owe ED Dt OD ee OE OD OO oe OF Oe ot Oe © oe ow on On ow amen see on 
ies. Login: 

push es 
mov ax,cmemseg 
mov es,ax 
MOTre 0% 00x 
Ome we Lae x 
mov cl,ndsks 

again: 
mov logtbl {px}. 


set up to index logtbdl 


disk free? 

so, enter console # 
console already logged 
not, restore loetbl 


71S 
log 
71S 
Eile 


»clear bx 
pOme Set in loetbl 


»enter console number 


srestore loetdbl entry 
sreyuest another disk # 


Finitialize loetsl ertries 


saddress common memory 


entry .for each disk 


s;initialize elements of 


Pac. ox PEeceto. 10 2 

loop again 

pop es 

ret 
9 EAE ERE EAE EAE HE TO OE AE AE SE OE EO OE OE OE DiS BE HR AS SK HE DE IK AS AS IR KS OS AE HS SK 3K AE AE AS OK OS OK OK OE IE AS KR AS OR RK OK OE OE OE 
; Data Area 
8 REAE BEDE NE BE RENE AE AE A SHEE Oe BE OS HR NE OK ON 2 SE OK NCS Oe OE BE NEE OE OE AE DEE EI NE BE BE NE OE 2 RE SHEE RE OE AE DISSE BIS EIR OE AE 2 oe 
user rd i 
console rb il 

- ¢ . ° —~ 7 ? 
losmsegl Teoh leernter Loot wor sk Letter (AiD,f.F. >) 
‘at Cebit) 

logmsgZ Coens «sinter Console Number (1,2 ,5.4)° 


(Ji 
CN 





LAL ase 
"Pp ft i*) —— 


| i | : 





C0eNcCr, lt, / 


logmsg3 db cr,lf, Disk in Use ---- Reselect’,cr,1/,¢ 
eseg 
org 2evh 

logtbl rb «ndsks sallot memory for logtbl 
cseg $ 


send login.a&6é 





APPENDIX N 
PROGRAM LISTING OF SYNC.A&6 
»>Prog Name :Syncn.A86 
>Date :7 October 1982 


»sWritten by :Nick Hammond 
sModified oy :T. Almaquist and D. Stevens 


»For >Thesis 
»sAdvisor :Professor Kodres 
;Purpose >:Provide synchronizations of CPM/86 read 


and write operations to the MBB-&S@ bubddle 
memory board and the REMEX Data Warehouse. 


ACNE AE AS AS AE AE AE SK AC NE NE HE AE AE KE IKE AEE HE IE HE YS EE AE BK STE AES HS OE SS OEE OS ES EAS A he OS OE AE OK AE OK AE NE OE AE OK OIE AS OK 


synchronization Routine 
NEE HE NE DHE OK OFLC he OYE AK aE ANC OIE OE IE OE OE BC AIS BS NC EE NE EE NE OIE OIC OE NE OK OS BIE ONC DIE SIE OK NE NE HC NSE ik IC Ne oe aN OE aK OK NE KS CO oe BE a ais 


@206¢ @2e 3 we SOC We we We 


9 RE A 2S SESH Ee 22K OK SK COR AE AK BE AE aK a aK RENE 2K OE a OE AE KA a 2 DI SCA BE aK A ORC AE AE OE RICE Ae Re ot oF 2 
} EBquates 
oS HE REA BAK AK NC 3 BS OE HE OK SI AE OS BEE OED OK ICE 2 RE ENE OK NE SEE OS 2 OE He aE a SK EOI aK BK BE a DE BERK 2K aI 


cmemseg equ dedddh ,Sseement address of 
,cOommOon memory 
dcount equ 19d sous contention time delay 


BEAK HEHE HE OC KE SHE Be EK OE AE AC ake NE KE OK BIS OS OK OK SE RE BK OK a OC EK NE HE AS AE BC BI OK SE OC ES AE NE OK OK OE OK OE OE NE OK OE AS IE OE OE HICK 
Suoroutines 


26 we we 


ETE AE NE Oe NE OK AE oe XE BN Oe ae aie BC a 2 OE OK OS ok oe He SI Se 3K oft oe ae afc ak ok afc ake ae ote ae ae ake ic of aie ale oie oe ake of se oie off aie oie ie x ok 
cseeg $ 
ticket: sreturn the next ticket number in 
> dx 
xor ax,ax »set reserved vaiue 
10CK nehg ax ,next »get ticket number 
test ax,ax 
jz ticket srepeat if reserved 
Mov bx,ax sreturn next ticket 
iae. ax 
Vow Gacl 
inc ax ;SKip reserved value 
ee 13 mov next,ax sincrement ticxet number 








advance: 


Lane 
sez 
nc 
aay 1: ret 


bx, server 
awa2 

ei macouns 
Cx 

awal 
await 


server 
advl 
server 


;Wait for server number to match 
;the customers ticxet number passed 
sin bx. To reduce bus contention, a 
delay is used between periddic 
schecks of the server number 


,if ticket = server 


scontinue process 
jet een Ont eniS Cited elas 


sincrement server number to next 
;Value 


;server=serverrl 


;skip reserved value 


eo > oe es ets ee ee ee ee es ee ee ee es ee ee ee ee ee ee eo ee es es ee ee eee es ae ees ee ee es ees es ee es es ee oe es es ee ce ee es ee ee 


release; 


push 
On. 
Mov 
Gad 
pod 
me 


mo. tSVGC : 


es 
ax,cmemseg 
esc 

ta cket 
await 

es 


es 
ax,cmemseg 
CSs,ax 
advance 

as 


sZ2et a ticxet number and wait to pe 
;served 


;set es to address common 
smemory 

;get ticxet number 

s;Wait to de served 


sadv server number on completion 
;of read or write operation 


,set es to address common 
smemMory 
,;inc server number 


sinitialize sequencer variables 


seh 


push es 


Mov ax,cmemseg set es to address common 
mov e€S,ax ymemory 
WOVv ax, »;server=next=l 


mov server,ax 
mov next,ax 
pop es 


o SESE He aK MERE a aK OR CE SK OAR aA A aE fea ee aR ae a AE a ae at A NE 2S Se aR a a a ake OK AE a BE a a 5K aa ok aK a 
’ Data 
03S BK ENE SSC EE 2 2 BR aK A a EOE AE aK 9 9 OO EDK ICSE HE 9K 2 REE BE AE A a MS NS BO OB BCE BO a OC RE OK A aK ae RE 


% 
+ 


eseg »,only one set of sequencer variabdles 
,exist in common memory; accessed 
yvia es 


server rw il 
next rw il 


csege $ 


;end syncn.a&6 
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